
















































































































はじめに 


はじめに 


この度は， MSX-C Library をお求め下さいましてありがとうございます， 

MSX-C Library は MSX のグラフィック機能やマウス，プリンタなどの補助入出力装®を扱 
ったり，現在の MSX-C のバージョン (VER1. ではサポートされていな t ゝ倍精度実数や LONG 
型演算をサポートするライブラリパッケージです. 

MSX-C バージョン 1.0 および 1.1 では標準ライブラリしか用意されていないために， C 言語 
から直接， MSX の特徴であるグラフィック機能やマウス，ブリンタ等を使用することはできませ 
んでした. 

MSX-C Library を使用することにより， C 言語でのプログラミングだけで MSX のほとんど 
の機能を使うことができ，本格的にブログラム開発をされる方にも，また，これから C 言語を学 
ばれる方にもご利用いただけます. 

なお，本ソフトウェアには MSX-DOS ， スクリーンエディタ， MSX-M-80, MSX-L-80, LIB 
-80, CREF-80, MSX-C は含まれておりません. MSX-C Library を使用してプログラム開発を 
行なう場合にはこれらのソフトウェアが必要となりますので •， お持ちでない方は 「 MSX-DOS 
TOOLS 」， . 「 MSX-CVer.l 」」 をお買い求め下さい.また，ブログラム開発を行なう上でデバッ 
グを効率的に行なうために， MSX 用シンボリックデバッガ 「 MSX-SBUGj が用意されていま 
すので，お持ちでない方は是非お買い求め下さい. 

本ソフトウヱアをご使用になる前に，添付の「ソフトウヱア使用承諾契約書」をよくお読みい 
ただき，ご確認のうえ，添付のューザー登録カードにご記入し，弊社までご返送下さい.ご返送 
をもって承諾契約書にご同意いただいたものといたします. 

この「ューザー 登録 カード」 をご返送いただけない場合には，弊社といたしましては所定のア 
フターサービスをいたしかねますので，よろしくご了承のほどお願い申し上げます。 

本バッケージには以下のものが含まれています . 

■ MSX-C Library システムディスク 1 枚 

(3.5-1DD フロッピーディスク） 

■ MSX-C Library ユーザーズマニュアル 1 冊 

■C23，MSX-DOS, MSX-M-80, MSX-L-80, MSX-C はアスキーの商標です. 

■ MS-DOS は米国マイクロソフト社の商標です. 

■ Z80 は Zilog, Inc. の商標です. 

_ UNIX オペレーテイングシステムは米国 AT&T のべル研究所が開発し， AT&T がライセンス 
しています. 


© ASCII CORPORATION 1988 




ご注意 

⑴このソフトウェアならびにマニュアルを賃貸業に使用することを禁じます.また，このソフト 
ウェアやマニュアルの一部または全部を無断でコピーすることはできません. 

⑵このソフトウヱアは，製品登録カードを返送して当社に登録済みの方に限り，使用したりコピ 
一したりすることができます.なお，このソフトウェアを個人使用以外の目的でコピーするこ 
とはできません. 

(3) このマニュアルに記載されている事柄は，将来予告なく変更することがありますが，当社に登 
録されている方には案内をお送りします. 

⑷製品の内容については万全を期しておりますが，製品の内容についてのご不審や，誤り，マニ 
ュアルの記載もれなど，お気付きのことがございましたら，マニュアルの巻末の「お問い合わ 
せ」についての要領で下記の問い合わせ先へお送り下さい. 

⑸このソフトウェアを運用した結果の影響については， （4) 項にかかわらず，責任を負いかねます 
のでご了承下さい. 

お問い合わせ先〒 107-24 東京都港区南青山 6-11-1 スリーエフ南青山ビル 

株式会社アスキー ユーザー サポート係 

TEL. 03-3498-0299 (祝祭日を除く月〜金） 

10:00〜12:00, 13:00〜17:〇〇 

⑹ MSX-C Ver. 1 . 1および MSX-C Library を使用して作成されたプログラムの販売については， 
下記にお問い合わせ下さい. 

お問い合わせ先亍 107-24 東京都港区南青山 5-11-5 住友南青山ビル 

株式会社アスキーシステム事業部 


TEL. 03-3486-8346 (祝祭日を除く月〜金) 
10:00〜12:00, 13:00〜17:〇〇 
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序草 MSX - C ライブラリベ，:/ケージの概要 


序章 MSX - C テ D ラリパッケージの概要 


Q .1 ライブラリ関数の概要 _ 

本パッケージは MSX - C で MSX のグラフイック機能やマウス，プリンタなどの補助入出力装 
置を扱かつたり，現在の MSX - C のバージョン ( VER . 1 .1) ではサポートされていない倍精度実数 
や Long 型演算をサボートするライブラリパッケージです • 

以下に本パッケージの関数を大きく 4つに分けて，具体的な内容を示します. 


クラフィックス関数パッケージ 

線画（ライン）や塗りつぶし（ペイント）から，スプライト， VDP へのアクセスまで， MSX のす 
ぐれたグラフィック機能を幅広くサポートする関数が用意されています. 


数値演算関数パッケージ 

数値演算を扱う関数群は大きく二つに分けることができます.まず, MSX - C ではサポートされ 
ていない LONG 型 (4 バイト整数，本パッケージでは SLONG 型として扱う）での四則演算を行 
うための関数.そして， MSX - BAS 1 C と同様の倍精度実数型の演算を行う関数群で構成されま 
す. 


その他の関数 

その他の関数として， MSX の機能を拡張するマウスやプリンタ，ライトペンなどの補助入出力 
装置を扱う関数や，スロット間での関数呼び出しを行うための命令などが用意されています. 


力ーソル制御 ( MSX - CURSES ) 関数パッケージ 

CURSES (カーサス）とは本来， UNIX というミニコンビュータ用の 0 S 上の，コンソール画面 
への文字表示やキャラクタウィンドウをサボートするためのライブラリ関数の総称です. MSX - 
CURSES はサブセット（一部分）ながら CURSES の仕様を MSX - DOS 上で実現するものです. 



o . g 本マ 2 ァルの構成 _ 

本マニュアルではライブラリ関数全体を上に述べた4つの関数パッケージに分けて解説してい 
ます. 

以下の章では，まず本パッケージの意義と位置づけ，パッケージに含まれるファイルや，ライ 
ブラリ関数の全般的な使い方を述べた後，4つの関数群について詳細に具体的な関数の仕様とそ 
の使用法や，注意事項について解説していきます. 
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第 1 窣木パ./ ケージの:® 義と その 位； S つけ 


第1章本パッケージの意義 (!: その位置づけ 

MSX - C コンパイラのパッケージに標準ライブラリとして付属している関数群を見渡して，「グ 
ラフィックは使えないの？」とか「音は出せないのか， BASIC でできるのに」といった疑問をも 
たれた方も多いかと思います.ここではそもそも標準ライブラリとは何か，本パッケージのライ 
ブラリとどんな関係にあるのかについて解説します. 


1.1 標準 C ラィブラリ _ 

C 言語が UNIX というミニコンピュータ用の 0 S (オペレーテイングシステム）上のプ〇グラミ 
ング言語として発展し，また UNIX システムそのものも，その大部分が C 言語によりプログラム 
されているということはよく知られています. UNIX システムが世界中の大学，その他の研究機 
関で長い年月をかけて進歩してきたのと同様に， C 言語についても UNIX の発展と共に育った言 
語であるために， FORTRAN や COBOL の様に，厳密な工業規格の形ではその言語仕様の定義が 
なされていません.そこで， UNIX の C の設計者自身がその著書「プログラミング言語 C 」 （リッ 
チーとカーニハン）で示した仕様が一応の標準として多くの C の処理系がこれに準拠した形で設 
計されてきました （ MSX - C もその一つである）.さらに， C 言語の普及にともなって，より厳密な 
標準規格化への試みが進められています ( ANSI や JIS など).これらの標準化案も基本的に， 
UNIX - C を土台としたものであることは言うまでもありません. 

こうした C 言語の文法上の標準化と同時に，ライブラリについても標準ライブラリとしての標 
準化が進められています.標準ライブラリもまた UNIX - C のライブラリを基礎にしています. 
UNIX - C のライブラリは本来，その多くが UNIX システムそのものの持つ機能を呼び出すいわ 
ゆるシステムコールと， C 言語とのインターフェースという性格を持ちます.もう少し分かりやす 
く言うと，例えば， UNIX の C コンバイラで， i - ead () や writeO などの関数を用いたプログラム 
をコンパイルすると，実際にディスクに対して読み書きをするコードが生成されるわけでなく， 
READ , WRITE というシステムコールを，それぞれに必要なバラメータをセットして呼び出すコ 
ードに展開されるにすぎないのです. 


それでは， MSX - DOS 上で read 〇や write 0のような関数を実現するにはどうしたらよいでし 
ょう. MSX - DOS には READ や WRITE と同一仕様のシス テムコールはありません. しかし， 
MSX DOS にもディスクの読み書きを行-うシステム コールは あるわけですから，内部的にはそれ 
ら を用いて， C 言語のプログラムからは UNIX と同様の関数呼び出しを行うようにすること は 可 
能なわけです.すなわち，ライブラリという形で，システムと ユーザ プログラムとの間の 
インターフェースを統一すること で UNIX と MSX - DOS というシステムの違いが吸収されたのです. 

標準ライブラリという発想の意義はまさしくこの点にあり，ライブラリの外部的な仕様(関数名 
や，引き数，戻り値など取り決め）の統一が，それらの関数を使ってプログラムしているかぎり他 
の システム への移植を非常に容易なものとしているのです（場合によっては単に コンパ イルし直 




すだけでよい）. 


こんなわけで， C 言語のライブラリである以上，標準的な C ライブラリ（現在のところ UNIX - 
C ライブラリ）の仕様はできるだけ満たすようにしなくてはなりません.また，仮に MSX - C 独自 
の関数をライブラリとして用意するにしても，それらを標準ライブラリと混同することは， C 言語 
本来の移植性の妨げにもなるでしょう. 

MSX-C verl . l のマニュアルにおいても UNIX - C とのライブラリ関数の仕)#上の違いを特に 
あげているのは， MSX - C を使いこなすためはもちろん，ユーザにそのことをとくに意識してプロ 
グラムをしていただくためでもあったのです. 


1.2 。ラィブラリパッケージの位置づけ _ 

しかし， MSX のユーザにしてみれば， UNIX や MS - DOS などへの移植性もさることながら， 
MSX のもつすぐれたグラフィック機能や，ジョイスティックやマウスなどの特殊装置を十分に 
活かしたプログラムを作りたいと考えるのも当然の要請でしょう.本パッケージはこうした要請 
から， C コンバイラのパッケージとは別個に（標準ということを問題にしない） MSX 独自の数々 
の機能を C 言語により用いるためのライブラリバッケージなのです. 


本パッケージをこのように位置づけると， MSX - BASIC を手本として関数の仕様を決めるとい 
ったことが考えられます. MSX - BASIC はおよそ MSX の機能をフルにサポートしているので 
MSX 専用のライブラリをつくるには大いに参考となるわけです.ただ， C の関数を BASIC の命 
令とまったく同じ仕様にしたのでは， C 本来の柔軟性やエラーチヱックはユーザ自身がプログラ 
ムで行い，関数の機能はできるだけプリミティブなものにするという思想からも外れてしまいま 
す(極端な話間違った関数の使い方をすると syntax error などど表示されたのではたまりませ 
ん) • 

そこで，本パッケージは， MSX - BASIC を大いに意識して広く MSX の機能をサポートしなが 一 

らも，個々の関数の機能を単純にして，エラーチェックなどはユーザの裁量に任せるようになっ 
ています.従って，ある意味では BASIC のように単純には行かないのですが，ユーザがより自由 
に 「 C らしい」プログラムを書くことができるでしょう. 

また，第6章で詳しく述べていますが，本パッケージには MSX - CURSES という関数群が含ま 
れています. CURSES (カーサス）とは UNIX 上の「圃面更新とカーソル動作の最適化のためのラ 
イブラリパッケージ」，すなわちテキスト画面を扱うアブリケーシヨンのための_数群の総称で 
す.この説明ではちょっとピンとこないかも知れませんが， UNIX 上のスクリーンエディタ vi 
や,口ールプレイングゲームの元祖とも言うべき Rogue (ローグ）などが CURSES を用いたアブ 
リケーシヨンとして知られています. 

MSX - CURSES はその名のとおり UNIX の CURSES のサブセット（一部分）となっています（一 
部関数の仕様が異なるところもある）.この点では MSX - CURSES の関数群については，グラフ 
ィックなどを扱う他の関数とは区別する必要があるかもしれません. 
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第 2 章 MSX - C ライブラリバッケージの使用法 


第2童 MSX - C ライブラリパッケ-ジの使用法 

s . i パ ッケージの内容 _ 

本パッケージに付属のディスクに含まれるフアイルの一覧を示します. 


オブジェクトファイル 

mlib.rel MSX-C ライブラリのオブジェクトファイル 

glib.rel 以下， MLIB.REL を4つに関数パッケージに分割したオブジェクト 

math.rel 

msxbios . rel 

curses , rel 


• TCO ファイル 

mlib.tco 本ライブラリ使用のプログラムのパラメータチエツク用の. tco ファイル 

(標準ライブラリの lib.tco に匹敵するもの） 


ヘッダーファイル 

Klib.h 
math . h 
msxbios . h 
curses . h 


グラフイツク関数群の宣言やいくつかの型定義など 
数値演算関数群の宣言や，データの型定義など 
MSX の BIOS を呼び出している関数の宣言など 
MSX-CURSES の関数群の宣言やデータ構造体の型定義など 


ユーサブログラム作成用バッチファイル 

msxc.bat 本ライブラリを用いてプログラムを作成するためのバッチ 

MSX-C のパッケージに付属する c.bat にあたるもの 


ライブラリソースファイル 

glib . mac 
glibc.c 

mathmac . mac 
mathc . c 


prsc.c 

msxbios.mac 

msxbiosc.c 

cursesc.c 

curses 2 .c 


ライブラ 1 J 保守用のファイル 


genall.bat 
genglib . bat 
genmath.bat 
gcnbios.bat 
gencurs . bat 
genmlib.bat 
gentco . bat 
gen.bat 
glib.tco 
math , too 
msxbios.tco 
curses , tco 


以下， curses , tco までの. tco フアイルはライブラリに変更を加えた際に 
mlib . tco を再作成するためのもので，実際のパラメータチヱックには 
mlib . tco のみで足りる. 




ユーティリティーブログラム 

echo.com ライブラリ再作成の際にもちいるプログラム 

mx.com 同 X 


サンプルブログラムファイル 

den.c 
den . com 
show . c 
show . com 
gcal.c 
gcai.com 



mksys.bat 本パッケージを用いたプロダラム開発環境デイスクをつくるためのバッチ 
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第 2 章 MSX - C ライブラリバッケージの使用法 


forremk.bat ライブラリ再作成用のシステムファイルをつくるバッチ 

readme . doc 最新の更新事項の情報 


g , g ライブラリパッケージの使用法 _ 

本パッケージに付属のディスクには MSX - DOS のシステムや， MSX - C コンパイラそのもの， 
標準ライブラリなどプログラムの開発に必要なファイルが含まれていません. 

そこで，まずはじめにすることは，いままでお使いの MSX - C コンパイラのシステムディスク 
に本パッケージ中から必要なファイルをコビーするなどして，ブログラムの開発環境としてのシ 
ステムディスクを作ることです. 

通常の本ライブラリを用いてのブログラム開発では，いままでにお使いの MSX - C コンパイラ 
のシステムディスクに，本バッケージ付属のディスクから以下のファイルをコビーすれば足りる 
でしよう. 

バッチファィル 

msxc . bat 

ライブラリファイル 

mlib.rel 


バラメータチェック用 TCO ファイル 

mlib.tco 


ヘッダーファイル 

glib.h 
msxbios . h 
math . h 
curses.h 

'また，本パッケージには，新しく.おろしたてのディスクから MSX - DOS - TOOLS や MSX - C コ 
ンバイラ ver .1.1 のディスクから必要なファイルを次々とコピーし，システムディスクをつく 
るためのバッチ， mksys . bat も用意されています.このバッチを用いてシステムディスクを作成 
するには本パッケージのディスク，新しくフォーマットしたディスクの他に MSX - DOS-TOOLS 
や MSX - C コンバイラ ver . 1 . 1のディスクが必要です. 


mksys . bat の起動法 

まず，新しいディスクに mksys . bat をコビーして下さい.次にそのディスクをカレントドライ 


ブに揷入し， MSX-DOS 上で次のように入力してください.ディスクのライトプロテクトははず 
しておいて下さい. 

A > mk$ys <ドライ：7名> (ドライブ名の指定にコロンはいりません） 

ドライブ名は省略できません.ドライブが1台の場合は2ドライブシミュレータを用いて下さ 
い.ドライブ名の指定にコロン （ ’：’ ） は必要ありません.実際の mksys.bat の起動は次のように 
なります. 


A>mksys b 0 

これでバッチが起動され， TOOLS や MSX-C ver • 1 . 1のディスクの挿入を要求するメッセー 
ジが表示されますから，それにしたがってディスクの入れ替えをしてやれば，新しいディスクに 
次々に必要なファイルがコビーされシステムディスクができあがります. 

g ■ g • 1ソースファイルの作成(ヘッダーファ イルのインクルード)_ 

C では，関数をブログラムで用いる場合，用いる関数を予め宣言しておくのが原則です.標準ラ 
イブラリの場合は stdio . h などのヘッダーファイルと呼ばれる特殊なファイルをインクルードす 
ることによりユーザプログラムの ソース 内でいちいち個々の関数を宣言しなくてすみ ま した. 

本パッケージでも同じように，関数の宣言やデータの型宣言などをおこなっているファイルを 
用意しています.これらを必要に応じてインクルードすることによりユーザはそのプログラム内 
で自由にライブラリ関数や定義された定数などを使うことができます. 

インクルード用のへッダーフアイルには下のようなものがあります. 


glib.h 
math.h 
msxbios.h 
curses.h 


インクルードすべきヘッダーファイルは用いる関数によつて異なります，具体的には次章以下 
の各関数群の使用法をご覧下さい. 


g _ g _2 コンパイル 

ソ_スフアイルが書けたら通常どおりにコンパイルしますが，この際 MSX-C のパッケージに 
含まれている c.bat などの， FPC によりパラメータチヱックを行っているバッチ処理では確実に 
エラーが起こります.なぜなら c.bat で FPC のチェックの対象としている lib.tco では本パッケ 
ージの関数はまったく定義されていないからです. 
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そこで，本パッケージの全ての関数のプロトタイプ宣言(関数の骨組みだけを定義している）を 
含む TCO ファイル， mlib . tco を併せて FPC にわたすことによりパラメータチェックを正常に 
行うことができます. 

パラメータチヱックの書式は以下の様になるでしょう. 
fpc lib mIib prog 

この例ではユーザブログラムファイル prog . c を CF にかけて生成した prog . tco のパラメー 
タ チェック をっています. 

もうひとつ CF について述べておかなくてはならないことがあります.ソースファイルでイン 
クルードするヘッダーファイルのなかでは多くの関数や定数，変数が定義されています . CF 実行 
時には，これらのグローバルに定義された関数名や変数名などはソースのなかでの参照の有無に 
関係なく，そのためのシンボルテーブルがつくられます.このため， stdio . h のみをインクルード 
していた場合に比して， CF 実行時にシンボルテーブルオーバー フローの エラーがおきやすくな 
ります.この場合 CF のオプションによりシンボルテーブルの割合を少し增やしてやることによ 
りほとんどエラーなく終了する こ とができます. 

後述のバッチ msxc . bat でも CF 実行時のオプションの指定が可能になっています. 

2.2.3 リンク _ 

コンパイルが済んだらライブラリの本体である REL ( mlib . rel ) ファイルも含めてリンクを行 
います.本パッケージのライブラリファイルは，ただ1 つの REL ファイルにまとめられています 
が，正式なライブラリ化により作成されていますのでリンカ （ MSX - L 80) の / S オプションによ 
り必要なモジュールだけを抜き出して結合することができます. 

ライブラリファイル名は mlib . rd です.本ライブラリ関数を用いたプログラムのリンクの際に 
は必ずこれをリンクする必要があります. 

リンクの際には， mlib . rel は，標準ライブラリファイル clib . rel やランタイムライブラリファイ 
ル crun . rel ， cend . rel よりも前にリンクしてください.本パッケージのライブラリ関数のなかに 
は標準ライブラリを内部で呼び出しているものや，標準ライブラリ関数と名前が重複するものが 
あるからです. 

リンクの書式例を示します. 


r 正しい例 ~i 

180 ck ， prog,nil i b/s,cl i b/s,crun/s,cemJ,prog/n/y/e : xmain 


r 誤った例 1 

180 ck,prog,clib/s,mlib/s,crun/s t cend,prog/n/y/e：xmain 



(この場合未定議エラーがでたり，同じ名前の標準ライブラリをリンクしてしまう場合がある〉 

以上，ユーザプログラムの作成手順をおおまかに追ってみたわけですが，ここまでの一連の処 
理をバッチファイルにしたものが msxc . bat として提供されています • 

msxc . bat の内容は以下のとおりです.バッチ起動時のパラメータの2番目，3番目がそれぞ 
れ， CF ， CG のオプション|旨定に用いられるのがわかるでしょう 


cf %2 %\ 
fpc XI in ] i b lib 
eg -k %3 %l 
m 80 -%\/2 
del %\.mac 

180 ck ， Xl ， mlib / s ， clib / s , crun / s , cend , X 1/ n / y / e：xmain 

また， nilib . rel は本バッケージの全ての関数を含んだファイルでしたが，これを4つの関数群 
にわけたファイルも用意されています. 

glib.rel グラフィシク関数パッケージ 

math.rel 数値演算関数バッケージ 

msxbios.rel マウス やプリンタなど基本的入出力関数バッケージ（本 マニュアルではそ 

の他の関数として分類されている） 
curses.rel MSX-CUKSES バツ ケージ 

たとえば Long 型の演算関数のみを使う場合には， mlib • rel にかえて math.rel をリンクする 
ことにより多少リンクに要する時間が短 if 宿できることがあります. 

ただし，個々のライブラリ関数の中には，内部的に，他の関数群に属する関数を呼び出してい 
るものがいくつかあります.この場合，リンカは呼び出されている関数の実体を与えられた REL 
ファイルから見つけることができず，未定義エラーとなります.こうした際には miib.rel でリン 
クしなおして下さい. 


5.3 ライブラリの保守 _ 

ユーザが本ライブラリを使い込むうちに関数の細かい仕様を改良したり，新たに自分で作成し 
たサブルーチンをライブラリに加えたいと思うことがあるでしょう•本パッケージにはライブラ 
リの本体である RKL ファイルを再作成するために必要な全てのソースファイルを含んでいます 
ので，各ユーザがソースレベルで改編して自由に自分なりのライブラリパッケージを完成してい 
くことができます. 
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g _3 _l ソースファィルの作成 _ 

ライブラリのソースを直接編集して新しいライブラリファイルの作成までを行うわけですから， 
作業の前にもとのライブラリのバックアップを作っておくことをおすすめします. 

バックアップの取り方 

MSX-C ライブラリパッケージのディスクをドライブ A に入れ，フォーマット済みのディスク 
をドライブ B に入れ (2 ドライブシミュレータの場合は入れずに），次のようなコマンドを実行し 
ます. 

A>copy a : 李.* b : 0 

(実際の表示省略） 

2ドライブシミュレータの場合は MSX-DOS からのメッセージに従ってディスクを交換して下 
さい. MSX-DOS のプロンプトの A > が出たらバックアップは完了しました.ソースファイルの 
編集などはこのバックアッブされたディスクでおこなって下さい. 

次にエディタを起動してソースファイルを編集します. 

ここで注意すベきなのはソースファイル中の関数のおかれる順番です.最終的な目標である 
glib . rel , mlib.rel などは，リンク時に必要な関数だけを抜き出すことができ,る本格的なライブラ 
リですから，この場合，ライブラリ関数内で別のライブラリ関数の呼び出しを行っているときに 
は，呼ばれる側の関数はソース中では必ず呼ぶ側よりも前で定義されて（書かれて）いなくてはな 
りません（この理由については MSX-C 付属のマニュアルのライブラリの作成の項をご覧下さ 
い). 

こうして必喪な変更を加え，できあがったファイルをディスクにセーブすればソースの作成は 
完了です. 

a .3. g へッタファィルの変更 

次は変更を加えたソースに対応するヘッダファイルに新しく加えた関数の宣言をします.こう 
することで新しく加えた関数を，ヘッダファイルをインクルードするだけで使うことができるよ 
うになります. 

£■3,3コンパイル，アセンブ ルとバッチファイル _ 

ヘッダファイルの変更までできたら，ソースをコンパイル，アセンブルします.これには一気 
にライブラリ化するためのバッチファイルが用意されています.これを走らせることによりすべ 
ての REL ファイルと TCO ファイルを生成します. 

ここで使用するバッチファイルは genall.bat です. 



A ) バッチファィルを起動する前に 

ライブラリファイルが無事に作成されるまでには多くのファイルがディスク上に作られたり消 
されたり，あるいはリネームされたりします.ディスクの容量がいっぱいになりバッチが途中で 
止まってしまったり，大事なファイルが消されてしまったりなどのトラブルを防ぐためにライブ 
ラリの再作成には専用に1枚ディスクを用意されることをおすすめします.ただし，ディスクド 
ライブが1台のみの方の場合，2ドライブシミュレータにより2枚のディスクを用いることがで 
きますが，処理時間と手間がた I . >へん大きいので1枚のディスクで行なう方が効率的かも知れま 
せん. 

■ 2枚のディスクを用いる場合 （2 ドライブシミュレータの場合も含む） 

1枚目のディスクには下のようなファイルが必要です.これをライブラリ作成用のシステムデ 
ィスクと呼びます. 

システムディスクはふだんお使いの MSX - C 用のシステムディスクに足りないファイルを本 
パッケージのディスクからコピーすれば良いでしょう，必要なファイルをコピーしたらライトプ 
ロテクトをオン（書き込み禁止状態）にしておいて下さい. 


システムディスクに必要なファイル 


msxdos.sys 

command.com 

cf . com 

cg . com 
m 80 .com 
lib 80 .com 

fpc . com 
mx.com 
echo , com 
genall.bat 
genmath . bat 
gencurs.bat 
genglib.bat 
genbios.bat 
genmlib.bat 
gentco . bat 

gen . bat 
arel.bat 


crel.bat 


コンバイラ本体，バーサ 

コンパイラ本体，コードジェネレータ 

アセンブラ 

ライブラリマネージャ 
パラ メータチェッカ 

ライブラリ保守支援ツール，本パッケージに付属のもの 
本バ ッ ケージに付属のもの 
起動に使うバッチ 


最後に起動されるバッチ Uib から. rel へのリネームを行なつている） 
TEMP . BAT の生成に必要なファイル（アセンブラ処理のブロトタイプが 
定義されている） 

同 上 ( C ブログラムの処理のプロトタイプ） 
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stdio.h 

標準入出カヘッダーファイル 

bdosfunc. h 

MSX - C コンパイラ1 . 1に付属のもの 

glib.h 

へッダー ファイル 

math.h 

へッダー ファイル 

msxDios. h 

ヘッダーファイル 

curses.h 

msxbiosc.c 

msxbios.mac 

glibc.c 

ヘッダーファイル 

glib, mac 

mathc. c 

mathmac. mac 

prsc.c 

cursesc.c 

curses2.c 

関数を加えたり変更したソースファイ 

以上34ファイル 


もう一枚のディスク（これをここではワーク用のディスクと呼ぶ）は新しくおろしたディスクを 
フォーマットしてディスクのライトプロテクトはそのままオフ（書き込みができる状態）にしてお 
いてください.ワークディスクはフォーマットされたディスクであれば問題ありません. 

■ 1枚のディスクを用いる場合 

この場合は，システムディスクとワークディスクが兼用となります.この場合はふだんお使い 
の MSX - C のシステムディスタをそのままお使いになるのではなく，新しいディスタに上記の必 
要なファイルだけをコピーし，これをライブラリ作成用のシステム兼ワークディスクとしてお使 
い下さい.そうしないとバッチの途中でファイルを作ることができなくなる場合があり，ライブ 
ラリが再作成できません. 


B ) GENALL.BAT の起動 

必要なファイルが揃っていることを確認したら genall.bat を起動してみましよう. 

■ 2枚のディスクを用いる場合 

まずカレントドライブ（ブロンブトが 、' A >” なら A ドライブ）に上のシステムディスクをいれ， 
もう一方のドライブには新しくおろしたワークディスクを入れて下さい.このときカレントドラ 
イブのディスクだけがライトプロテクトされた状態です. 

ここではライブラリをすべて再作成しますから genall. bat に渡す引き数はファイルを作成す 
るドライブ名です.カレントドライブが A ドライブの場合，次のようにコマンド入力します.こ 



れは 2 ドライブシミュレータにより2枚のディスクを使う場合はまずカレントドライブのディス 
クをいれて同じコマンド入力となります.（ただし実際のオペレーションでは途中でディスク入れ 
替えのメッセージが表示され，それにしたがってディスクを入れ換えなくてはならない） 

A>genall b y (ドライブ名の指定にコロンはいりません） 

(実際の表示省略） 

■ 1枚のディスクを用いる場合 

必要なフアイルがすべて入ったディスク（システム兼ワークディスク）をカレントドライブ にい 
れます.ライトプロテクトはオフです.この場合，ライブラリファイルを作成するディスクは力 
レントドライブのディスクということですから， GENALL の 1 番目の引き数はカレントドライ 
ブ名となります. 

A>genall a @ 

(実際の表示省略） 


g .3.4 その他，注意事項 _ _ 

エラーがなく最後のバッチ gen . bat まで実行が終ったら，新しい関数を含んだライブラリの出 
来上りです.ふだんお使いの MSX - C のディスクにコピーして，これまでの MSX - C ライブラリ 
と同じようにコンパイル，リンクができます. 

これまで書かれたようにすることで，ユーザにあった MSX - C ライブラリにすることができま 
すが， genall バッチを1回実行するのに3時間から4時間ほどかかってしまいます.ですから追 
加する関数は十分デバッグしてからライブラリに加えることをおすすめします，また，バッチフ 
ァイルを解析することでより短時間にライブラリを更新することができるのが解ると思います. 


第 3 章グラフイ，ク関数バッケージ 


第3章グラフィック関数パッケージ 


3.1 グラフィック関数パッケージの概要 _ 

本パッケージ中には，グラフィック画面を扱うために数多くの関数が用意されています.これ 
をさらに下のような7つの関数群に分類しそれぞれについて解説を行います. 

• 初期化及び VRAM のアクセスに関する関数 
• VDP のレジスタを操作する関数 
•色を操作する関数 
•描画 

•スブライト 

•ビットブロック転送 

•その他の関数 

3,1,1 初期化及び VRAM のアクセスに関する関数 _ 

グラフィック関数を使用する前に必ず呼ばなければならない関数と， VRAM をアクセスする 
のに必要な関数を集めてあります. 

3.1 .S VDP のレジスタを操作する関数 — 

VDP (9918 や993 8) の内部レジスタを読み書きする関数群です. 

3.1.3 色を操作する関数 _ 

フォアグラウンド，バックグラウンド，ボーダーの色を設定したり，バレットを操作する関数 
群です. 

3.1.4 描画ルーチン _ 

グラフィック画面に描くための関数群. BASIC の LINE や CIRCLE ： などの図形を描くための 
命令に相幽するルーチンや ， PAINT (塗りつぶし）や PSET (点描）などを描画ルーチンとしてこ 
の部類にいれることができるでしょう.基本的には，これらの関数は BASIC 的な感覚で使えるの 
ですが，ロジカルオペレーション指定が可能かどうかや，カラーの有効範國などがスクリーンモ 
ードによって異なるため，注意が必要です. 
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3-1-5 スブ ライトに関す る ルーチン _ 

スプライトも画面表示には違いないのですが，単純に点や線を描くのとは違いスプライトの大 
きさやキャラクタのパターンを設定したりなどの前準備が必要です.本パッケージには，スプラ 
イトパターンやカラーの設定から実際の表示までに必要な全てのルーチンが揃っています. 

3-1- B ビッ トブロック転送ル ーチン _ 

ビットブロック転送というとちょっと聞きなれない言葉ですが， BASIC の COPY 命令に相当 
する一連の関数と考えれば良いでしょう. 

これらのルーチンを用いることによって，デジタイズやグラフィックソフトなどで作成した画 
像データを C のプログラムで自由に転送し，画面の任意の位置に表示することがでます. 

C 言語が人工知能などのブログラミングにも適していると言われていますので，画像データさ 
えうまく作れれば，ちょっとしたアドベンチャーゲームなどをつくることも可能でしょう. 

下位レベルの関数 ( VRAM アクセスや VDP レジスタの操作など）を除けばダラフィックを扱 
うほとんどの関数が，機能の面から考えると BASIC で馴染みのものばかりですから，例えば，「ス 
プライトとは何か j とか「スクリーンモードによる具体的な違いは何か」などについては MSX - 
BASIC のマニュアルや， 「 MSX 2 テクニカルハンドブック」などの解説をご覧下さい • 

但し， C では引き数の省略ができませんし，また細かいエラーチェックも行っておりませんの 
で， BASIC と比較して，弓 I き数や戻り値に十分注意した，よりきめの細かいプログラムを心がけ 
ねばなりません. 


3.2グラフィック関数パッケージの使用法 


3. EJ ソースファィルの作成 

ライブラリ関数群はいってみれば外部定義された（同ーソース以外でプログラムされた）関数の 
集まりですから，これらの関数を呼び出すさいには# include プリプロセッサ文により予め関数の 
宣言が行われているへッダーファイルを読み込まなくてはなりません. 

stdio . h のインクルードの後で glib . h をインクルードすることにより本章で解説するグラフィ 
ック関数をユーザは特に宣言することなく用いることができます.ただし glib . h のなかですべて 
のグラフィック関数が宣言されているわけではなく， glib . h のなかでさらに msxbios . h というへ 
ッダーファイルの呼び出しを行っていて，この2つのヘッダーファイルをあわせてはじめてグラ 
フィック関数の宣言が網羅されることになります. 

本章で解説するグラフィック関数を用いるブログラムのソースの先頭部分は例えば次のように 


18 












第 3 京グラフィック関数バッケージ 


なるでしよう. 


# pragma nonrec 


ft include < stdio . h > 〇ヘッダーのインクルード 

#include < glib . h > 


funcKfore , back , bard ) 

TINV fore, back, bord ； 

/ 

screen (( TINY )8)； O 実際にグラフィック関数を用いている部分 

color ( fore , back , bord ) 


glib . h のなかでは関数の宣言だけではなくいくつかの型や定数の定義などもおこなわれてい 
ます. glib . h で定義された型などについてはこれらを用いる必要のある個々の関数の解説中でそ 
のつど解説します. 


3. g , g コンパイル，リンク _ 

前節で述べたように glib . h のなかで msxbios . h がインクルードされていますので， cf (コンパ 
イラのフロントエンド）をかける際には，カレントドライブのディスクには glib . h のほかに 
msxbios . h が必要です. 

第2章で述べたように，本バッケージでは，バラメータチェック用の TCO ファイルやライブラ 
リファイル （ REL ファイル）は関数群毎に分けず，それぞれ1ファイルにまとめていますので，パ 
ラ メータ チェックについては 

mlib.tco 

リンクの際には 

miib.rel 

を fpc ， 180のパラメータとして与えます.詳しくは 2.2 をご覧下さい. 


19 



3.3 グラフイツク関数一覧 


初期化及び VRAM のアクセスに関する関数 


関数名 1 

i 用途 参照 ページ 

ginit 

グラフィック関数を呼ぶ前に必ず呼ぶ関数 

23 

interlace 

インターレースモードの設定 

23 

setrcl 

VDP を読み込みモードに設定する 

24 

invdp * 

VRAM から 1 バイトデータを読み込む 

24 

setwrt 

VDP を®き込みモードに設定する 

24 

outvdp * 

VRAM に 1 バイトのデータを， if き込む 

24 

vpeek 

VRAM の指定したアドレスの内容を返す 

24 

vpoke 

VRAM に 1 バイトのデータを書き込む 

24 

filvrm 

VRAM の指定領域を指定の 1 バイトのデータでクリアする 

24 

ldirmv 

VRAM からメインメモリへのデータ転送 

25 

ldirvm 

メインメモリから VRAM へのデータ転送 

25 


VDP のレジスタを操作する関数 


関数名 

用途 

参照ページ 

wrtvap 

VDP のコントロールレジスタにデータを書き込む 

25 

rdvdp • 

VDP のコントロールレジスタの内容を読み込む 

25 

rdvsts 

VDP のステータスレジスタの値を 返す 

26 


色を操作する関数 


関数名 

用途 

参照ページ 

color 

スクリーンのフォアグランド，バックグラウンド， 

ボーダーの 色設定 

26 

iniplt 

パレツ ト及び VRAM に保存され たパレツ トデータの初期化 26 

rstplt 

VRAM からパレ ツ トデータをリストアする 

26 

gctplt 

パレッ トの内容を返す 

27 

setplt 

パレツトのセツト 

27 


[_ 注意| * の付いた関数は割り込みフラグを変化させません.それ以外の関数は「割り込み 

許可 j で返ってきます. 
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描画関数 


関数名 

用途 

参照ページ 

pset 

グラフィック画面に指定色で点を描く 

27 

line 

2点の指定座標を結ぶ直線を描く 

28 

box line 

2点の指定座標を対角とする四角形を描く 

28 

boxfill 

2点の指定座標を対角とする四角形を塗りつぶす 

29 

circle 

指定座標を中心とする円を描く 

29 

paint 

グラフィック両面の指定された境界色で囲まれた部分を指定の色で塗 
りつぶす 29 

point 

グラフィック画面の指定の座標の色コードを返す 

30 


スプライト関係の関数 


関数名 

用途 

参照ページ 

inispr 

全てのスブライトの初期化 

30 

calpat * 

指定されたスプライトバターンに対応するスブライトパターンテープ 

__ 1 

ルの先頭アドレスを返す 

31 

calatr * 

指定したスプライト面に対応するスプライトアトリビュ 

ートテーブル 


の先頭アドレスを返す 

31 

sprite 

スブライトハターンの設定 

31 

colspr 

スプライトのライン毎の色を指定する 

31 

putspr 

スプライトの表示 

32 


ビットブ a ック転送 


関数名 

用途 

参照ページ 

cpyv 2 v 

VRAM の指定ページを他のベージへ転送する 

32 

cpyv 2 m 

VRAM の指定べージをメイン RAM に転送する 

33 

cpym 2 v 

メイン RAM の画像データを VRAM へ転送する 

33 


その他のグラフィック関係の関数 


関数名 

用途 

参照ページ 

totext 

スクリーンモードをテキストモードに戻す 

33 

grpprt 

現在のグラフィックカーソル位置に一文字表示する 

34 

knjprt 

現在のグラフィックカーソル位置に JIS 漢字コー 
を表示する 

ドに対応する文字 

34 

^locate * 

力ーソル移動 

34 

setpg 

VRAM の表示ページと書き込みページの設定 

35 

vramsize ♦ 

VRAM のサイズを返す関数 

35 
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3.4 グラフィック関数リファレンス _ 

本節では個々の関数の仕様と，その用法の解説をおこないます.関数の解説において，なじみ 
のうすいいくつかの変数型が用いられていますが，これは へッ ダー ファ イルのなかでつぎのよう 
に定義されています. 

TINY 符号なし1バイト整数型 • すなわち， char に定義 (typedef) されている. 

NAT 符号なし2バイト整数型， unsigned に定義されている. 

3.4-1 グラフィックに関するシステム変数 

グラフィック関数群のために以下にあげるようなシステム変数が用意されています.これらは 
実際には glib , h の中で定義されている# define マクロであり， MSX のワークエリアを直接参照 
します. 

TINY c dpage : 

TINY c_apage ; 

それぞれ現在の表示ページ，アクティブページを保持している変数です.参照は自由にできま 
すが，直接代入できるのは c_apage だけです. c_dpage を変更する際は必ず setpgO 関数を使用し 
てください. c_dpage に直接代入した場合の動作は保証されません. 

TINY c 一 fore ; 

TINY c_back : 

TINY c_bord ； 

それぞれ現,在のフォアグラウンドカラー，ノ<ックグラウンドカラー，ボーダーカラーを保持し 
ている変数です.参照は自由にできますが，直接代入できるのはグラフィックモードにおける 
c_fore もしくは c_back だけです.テキストモードにおいてもしくは c_bord を変更する際は必ず 
color 0関数を使用して代入してください.直接代入した場合の動作は保証されません. 

NAT cjastx ； 

NAT cjasty ； 

それぞれ一番最後に指定された X 座標， Y 座標を保持している変数です.参照，代入とも自由 
にできます.またこれらは glocateO 関数を使用して設定することもできます. 

主に連続した直線を引くのに， line 0関数と共に使用されます. 
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TINY c screen ； 

TINY c_sprite ； 

それぞれ現在のスクリーンモード，スプライトサイズを保持している変数です.参照は自由に 
できますが，代入するには必ず screen ()， inisprO 関数を使用してください. 

NAT c xmax ； 

NAT c ymax ; 

それぞれ現在のスクリーンモードで表示できる X 座標， Y 座標の最大値を保持しています•参 
照は自由にできますが，代入はできません.実際にはそれぞれ， gtxmaxO, gtymaxO に define 
されています. 

3.4.2 グラフィックに関する定数 _ 

グラフィック関数群のために以下にあげるような定数が用意されています.これらは glib. 卜の 
中で定義されています. 

□ジカルオペレーション 


PSET 0x00 

AND 0x01 

OR 0x02 

XOR 0x03 

PRESET 0x04 

TPSET 0x08 

TAND 0x09 

TOR 0x0a 

TXOR 0x0b 

TPRESET 0x0c 


3.4.3 初期化及び VRAM のアクセスに関する関数 


VOID ginitO 

グラフイック関数を呼ぶ前に必ずこの関数を呼び出してください. 
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VOID interlace (mode) 

TINY mode ； 

インターレ ー スモードを設定します•インターレースモードについては MSX-BASIC の マニ 
ュアルを参照してください. 

VOID setrd (adrs) 

NAT adrs ； 

VDP を adrs 番地からの読み込みモードに設定します•次の invdp 0と共に使用されます， 
TINY invdp 0 

VRAM から1バイトデータを読み込みます. 

VOID setwrt(adrs) 

NAT adrs ； 

VDP を adrs 番地からの書き込みモードに設定します.次の outvdpO と共に使用されます. 


VOID outvdp(data) 

TINY data ; 

VRAM に 1 バイトデータを書き込みます. 

TINY vpeek(vadrs) 

NAT vadrs ; 


VRAM の vadrs 番地の内容を返します, 


VOID vpoke (vadrs, data) 

NAT vadrs ； 

TINY data ； 

VRAM の vadrs 番地に data の 1 バイトを:®き込みます. 


VOID filvrm (vadrs Jen, data) 

NAT vadrs i 




第3¢グラフィック関数パッケージ 


NAT len ; 

TINY data ; 

VRAM の vadrs で指定したアドレスからの len バイトを data の値でうめます. 


VOID 

ldirmv(dst,src Jen) 

TINY 

*dst ; 

NAT 

src ; 

NAT 

len ； 


VRAM からメインメモリへのデータ転送を行しゝます. 

dst に転送先のメイン RAM のアドレス， src は転送元の VRAM のアドレス， len には転送する 
データ長をバイト単位で与えます. 

VOID Idirvm (dst , src, len) 

NAT dst ; 

TINY *src ; 

NAT len : 

メインメモリから VRAM へデータを転送します. 

dst に転送先の VRAM のアドレス， src に転送元のメイン RAM のアドレス， len には転送する 
データ長をバイト単位で与えます. 

3.4.4 VDP のレジスタを操作する関数 


VOID 

wrtvdp (vreg, data) 

TINY 

/reg ; 

TINY 

data ； 


VDP のコントロールレジスタにデータを®き込みます. 

.vreg でレジスタ番号を指定し， data で書き込む値を渡します. vreg は VDP のレジスタ番号で 
あり， MSX-BASIC の VDP コマンドとは 9 以上の場合 1 つずれていることに注意してくださ 
い.つまり MSX-BASIC でのレジスタ 9 はこの関数ではレジスタ 8 になります. 

TINY rdvdp(vreg) 

TINY vreg ； 

vreg で指定される VDP のコントロールレジスタの内容を読み込みます. vreg は VDP のレジ 
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スタ番号であり， MSX-BASIC の VDP コマンドとは9以上の場合1つずれていることに注意し 
てください.つまり MSX-BASIC でのレジスタ1()はこの関数ではレジスタ9になります. 

この関数は wrtvdpO を使用して VDP のコントロールレジスタに書き込んだ場合のみ有効で 
す. I/O 命令で直接 VDP のコントロールレジスタに書き込んだ時，この関数の動作は保証され 
ません. 

また vreg の範囲は0から23までです. 24以上の値を指定したときの動作は保証されません. 


TINY rdvsts(sreg) 

TINY sreg ; 


sreg で指定した VDP のステータスレジスタの値を返します. MSX-BASIC の VDP 関数とは 
レジスタの指定方法が異なることに注意してください. MSX-BASIC の VDP(8) は rdvsts(O) 
に， VD1M-1) は rdvsts(l) に相当します. 

3.4.5 色を操作する関数 


VOID color (fore, back , bord) 

TINY fore,back,bord ; 

スクリ ュンの フォアグランド，バックグランド，ポーダーの色を設定します. 

戻り値はありません.無効な色（スクリーン2上で256を指定したなど）に対しての動作は保証 
されません. 


厂使用例1 

# i nciude <?;td i o.h> 

#include <«lib. U > 

/ 氺 フォアカラーをバックに，バックをボーダーに，ボー ダを フォアに 変更す る */ 

VOID funclO 

{ 

col or(c bord, c： fore, c back)； 


VOID inipItO 

バレット及び VRAM に保存されたパレットデータを初期化します（ディフォルト値に戻す). 
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VOID rstpItO 

VRAM からバレ ッ トデータをリストアします . 

NAT getplt(pal) 

TINY pal ; 

pal で指定されたパレットの内容を返します . 戻り値として NAT 型の値 (setplt 参照）を返しま 

す . 


厂使用例 I 

# include < stdio . h > 
# include <glib . h > 


/* 指定されたバレットの緑のレベルを最高にする */ 
VOID funcl(pal) 

TINY pal ； 

{ 

NAT i ； 

i = getplt(pal )； 
setplt(pal, i I 0x700 )； 


VOID setplt (paLgrbdat) 

TINY pal ; 

NAT grbdat ； 

バレ ツトをセツトします . 

pal で設定したいバレツト番号を指定します .grbdat は 2 バイトの値で下位の 12 ビツトを 4 ビ 
ツト毎に区切って グリーン，レッド， ブルーの輝度を指定します.ビットの割当は以下のとおり 
です . 


Msb+ -+-+-+- +Lsb 

無効 緑の輝度赤の輝度青の輝度 


指定された パレット データは VRAM に保存されます . 


27 




3.4.6 描画関数 


VOID pset ( x , y f color , logop ) 

NAT x,y : 

TINY color ; 

TINY logop : 

グラフィック画面に指定色で点を描きます. 

( x ， y ) で指定した座標に color 色で点を描きます. MSX 2 マシンの場合，ロジカルオペレーショ 
ンの指定が有効です. 

x , y は自動的に cjastx , cjasty に代入されます. 

VOID line ( xl , yl , x 2, y 2 ,color Jogop ) 

NAT xl , yl , x 2, y 2 ; 

TINY color : 

TINY logop ; 


座標 ( xl , yl ) ，座標 ( x 2, y 2) を結ぶ直線を color で指定した色で描きます. 

MSX 2 マシンの場合， logop で， BASIC と同様のロジカルオペレーションの指定が可能です. 

: VISX 1 の場合や， ロジカルオべ レー ショ ンの指定の必要がない場合は， logop は省略せず必ず 
PSET を指定してください. 
x 2, y 2 は自動的に cjastx , cjasty に代入されます. 

\mrnm] 

# include < stdio . h > 

# include < glib . h > 


/* 三角形の表示 */ 

VOID funcK) 

{ 

iine(0, 0, 100, 50, (TINY)15, PSI-T )； 

1 ine(cjasix, cjasty, 50, 3 00, (TINY)15, PSET )； 
1 ine(c.lastx, cjasty, 0 ， 0 ， (TINV)!5, PSET )； 


VOID boxline ( xl , yl , x 2, y 2 ,color Jogop ) 
NAT xl , yl , x 2, y 2; 

TINY color ； 
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TINY logop : 

座標 ( xl ， yl ), 座標 ( x 2， y 2) を対角とする四角形を描きます.それ以外は line と同じです. 


VOID boxfill (x 1 , y 1, x 2 , y 2 , color , logop ) 

NAT xl , yl / x 2, y 2 : 

TINY color ; 

TINY logop : 

座標 ( xl , yl ), 座標 ( x 2, y 2) を対角とする四角形を塗りつぶします.それ以外は line と同じで 


す， 


VOID 

circle ( x , y , r , color , s _ ang し e _ angl , aspect ) 

NAT 

x , y,r ; 

TINY 

color ； 

int 

s _ angl , e_angl ; 

NAT 

aspect ； 


座標 ( x ， y ) を中心とする半径 r の円を color 色で描きます. s _ angl , e _ angl の絶対値はそれぞれ 
円の開始角度，終了角度を指定し，増加するごとに反時計回りに角度が変化します. 0は真右， 
200 0 H は真上，400 0 H は真左，600 0 H は真下を指定します. s _ angl , e _ angl が負の場合は円の中 
心へ向けての直線が引かれます.描画は開始角度から反時計回りに終了角度まで実行されます. 

aspect はアスぺクトレシオで， 1 H から 7 FFFH までの値が指定されると横長の，8001 H から 
0 FFFFH までの値が指定されると縦長の楕円が描画されます. 80001 - I が指定されると真円とな 
ります. 0を指定した場合の動作は保証されません. 1 •は常に長径を指定します. aspect と MSX 
- BASIC のアスべクトレシオの関係は以下のようになります. 

if (aspect <= 32768) 

アスぺクトレシオ ： aspect / 32768 ； 

else 

アスべク トレ シオ = 0 x 8000 / abs ( 65536 - aspect )； 

MSX-BASIC と違い color , s _ angl , e _ angl , acpect は省略できません . BASIC の 

CIRCLE (128, 100),80 

と同じ事をさせるには例えば以下のようにしてください. 

circle (128, 100，80, cjore , 0, 0 x 7 fff , 0 x 8000)； 
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x ， y は自動的に cjastx , cjasty に代入されます. 

VOID paint ( x , y , color , b 一 color ) 

NAT x,y : 

TINY color , b_color : 

グラフイツク画面の指定された境界色で囲まれた部分を指定の色で塗りつぶします. 

本ルーチンはスクリーンモードによって多少機能が異なります•スクリーンモード3もしくは 
5から8では， b _ color 色で囲まれた （ x , y ) を含む領域を color 色で塗りつぶします.これに対しス 
クリーンモード2ないし4の場合は境界色 ( b _ color ) の指定は無効で， color で頭まれた部分を 
color 色で塗りつぶします. 

スクリーンモードが2ないし4のときは， b _ color には必ず TINY 型のダミーの値をいれてく 
ださい. 

x ， y は自動的に cjastx , cjasty に代入されます. 

TINY point ( x , y ) 

NAT x,y ; 

グラフイツク画面の指定の座標の色コードを返します.弓 I き数として色を調べたい座標を与え 
ます.グラフイック関係の他の関数と違い， clastx , clasty を変更しません. 


3.4.7 スブライト関係の関数 


VOID inispr ( size ) 

TINY size ; 

全てのスプライトを初期化します. 

スプライトパターンはすべて0でうめられ，カラーは，フォアグランドカラーに初期化されま 
す.そして，スブライトは表示されない位置におかれます（水平位置がモード 0 から 3 では 209, 
モード 4 から 8 では 217). 

同時にスブライトサイズが size で指定した値に設定されます. size の取りうる値は以下の通り 
です. 

0 : 8X8 モード，拡大なし. 

1: 8X8 モード，縦横拡大あり. 

2 : 16X16 モード，拡大なし. 

3 : 16X16 モード，縦横拡大あり. 
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4 :スプライトの表示を禁止. 

4の「スプライトの表示を禁止 j は MSX 2 でのみ有効であり， MSX で size に4を指定した場 
合の動作は保証されません. 

NAT calpat ( pat ) 

TINY pat ; 

指定されたスプライトパターン （0 から255)に対応するスブライトパターンテーブルの先頭ア 
ドレスを返します. 

NAT calatr ( plane ) 

TINY plane ； 

plane で指定したスブライト面 (0 から 31) に対応するスブライトアトリビュートテーブルの先 
頭アドレスを返します. 

VOID sprite ( pat , data ) 

TINY pat , *data ； 

スプライトパターンを設定します. 

pat に設定したいスプライトパターン番号， data にはスプライトデータへのポインタを与えま 
す.スプライトサイズが 8 X 8 の時は data でポイントされるデータの最初の8バイトが， 16 X 16 
の場合は最初の32バイトが使用されます.長さが必要とされるデータ長に満たないときはパター 
ンの終わりの方は不定です. 


VOID colspr ( plane , color ) 

TINY plane , * color : 

スプライトのライン毎の色を指定します.これにより，スプライトパターンのビットが1の部 
分の色をライン毎にかえることが可能です.このルーチンはスクリーン4から8でのみ有効です • 
その他のモードではスプライト色は次の putspr で一色のみの指定が可能です.スクリーン0から 
3に対して実行された場合の動作は保証されません. 

plane でスブライト面番号を指定し， color にライン毎の色，その他のデータへのポインタを与 
えます. 

color のデータはスプライトのサイズにより S 初の8バイトまたは】6バイトが有効となりま 
す，データがこれに満たない場合は終わりの方のラインの色は不定です. 
color データの各バイトは具体的に次のような意味を持ちます. 
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MSB LSB 

H - 1 — : — I - 1 - 1 - 1 - 1 - 1 - h 

EC CC IC 0 Color code 

実際にスプライトラインの色として有効なのは，下位の4ビットだけで，上位の3ビットが特 
に次のような意味を持ちます. 


EC ： 

32 ビット左シフトを 1 

= おこなう 


0 

= おこなわない 

CC ： 

優先順位の有無 1 

=優先順位なし 


0 

=優先順位有り 

IC ： 

衝突の検出の有無 1 

= 検出しない 


0 = 検出する 

ただし EC ビットに関しては， putsprO で x 座標に応じて変更されますので，このビットを積極 
的に使用する場合は putsprO を実行した後毎回 colsprO を実行しなければなりません. 
EC , CC ， IC の各ビットについての詳細は 「 MSX 2 テクニカルハンドブック」などをご参照下さ 

い. 

VOID putspr ( plane , x , y , color , pat ) 

TINY plane , color,pat ; 

int x,y ; 


スプライトを表示します. 

plane 面に pat パターンを割当て，画面の （ x , y ) にスプライト面の左上端を廣きます.また，ス 
クリーン4から8では colspr でスプライトカラーを指定するので， color は意味がありませんが， 
省略はできません.この場合 color には任意のダミーの値をセットして呼び出して下さい.この命 
令のみ int で座標を指定します.座標の範囲は一32から255となります， 
x , y の値は自動的に， cjastx , c _ lasty に代入されます. 

3.4,8 ビットブロック転送 

ビットブロック転送関数は MSX - BASIC の COPY 命令に相当するものです.スクリーン5から 
8までで有効です. 

VOID cpyv 2 v (sx 1 , sy 1, sx 2 , sy 2, sp , dx , dy , dp , logop ) 

NAT sxl # syl , sx 2, sy 2 ； 

TINY sp ; 
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NAT 

dx,dy 

TINY 

dp ; 

TINY 

logop 


VRAM のべージ sp の ( sxl , syl ) から ( sx 2 f sy 2) の領域を，ページ dp の （ dx ， dy ) へ転送します. 
dx ， dy の値は自動的に， cjastx , c _ lasty に代入されます. 

VOID cpyv 2 m ( sxl , syl , sx 2 1 sy 2 / sp , dest ) 

NAT sxl , syl , sx 2 / sy 2 ； 

TINY sp ; 

TINY * de$t : 

VRAM のページ sp の （ sxl , syl ) から （ sx 2， sy 2) の領域を， dest でポイントされるメイン RAM 
に転送します. dest の先頭2ワードには x 方向， y 方向のドット数（それぞれ sx 2 — sxl + 1， sy 2 — 
syl + 1) がこの順に設定され，その後に実際のデータが続くように設定されます. 
sx 2, sy 2 の値は自動的に， cjastx , cjasty に代入されます. 

VOID cpym 2 v ( src , dir , dx , dy , dp , logop ) 

TINY *src ; 

TINY dir ; 

NAT dx,dy ; 

TINY dp ; 

TINY logop : 


src でポイントされるメイン RAM の画像データを， VRAM のページ dp の （ dx ， dy ) へ転送し 
ます. 

転送するデータは，先頭部分に画像の x 方向， y 方向のドット数の情報を持っていなくてはなり 
ません.この形式を持つデータとしては，上の cpyv 2 m () によって VRAM から転送したデータや 
BASIC の COPY 命令により VRAM からファイルにコピーした データな どがあります ♦ 
dir では転送の方向を指定しますが，具体的な指定方法は MSX - BASIC の COPY 命令と同じ 
ですので，そちらをご参照下さい. 


3.4.9 その他のグラフィック関係の関数 


VOID totextO 

スクリーンモードを強制的に以前のテキスト モー ドに戻します.テキスト モードで この ルー チ 
ンを実行しても何もおこないません. 
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引き数，戻り値はありません. 


VOID 

grpprt ( ch , logop ) 

char 

ch : 

TINY 

logop : 


グラフィックスクリーンに対して， cjastx , cjasty の位置に文字 ch を表示します. 
ch は1バイトのキャラクターです. cjastx ， c _ lasty は次の文字の位置を示すように更新され 
ます. logop でロジカルオペレーションを指定します.スクリーン2から4では logop は無視され 
ますが，省略せずに必ず TINY 型の数値を指定してください. 

スクリーン2から4では文字のドットがオンになっている部分のみがフォアグラウンド色で表 
示されます.スクリーン5から8では文字のドットがオンになっている部分はフォアグラウンド 
色に，オフになっている部分はバックグラウンド色になり，これに対して指定されたロジカルオ 
ベレーションが実行され表示されます. 

本ルーチンで漢字を表示することはできません，漢字の出力には下の knjprtO を使用して下さ 

い. 

VOID knjprt ( JIS _ knj , logop , mode ) 

NAT JlS^knj : 

TINY logop : 

TINY mode ； 

グラフィックスクリーンに対して， c _> stx , cjasty の位置に， JIS _ knj であたえた JIS 漢字コ 
ードに対応する文字を mode で示す表示モードで表示します. 

本命令はスクリーン5から8に対してのみ使用できます. cjastx , cjasty は次の文字の位置を 
示すように更新されます. logop でロジカルオべレーションを指定します. 

文字のドットがオンになっている部分はフォアグラウンド色に，オフになっている部分はバッ 
クグラウンド色になり，これに対して指定されたロジカルオペレーションが実行され表示されま 
す. 

mode に関しては，以下のような3種類の表示モードが有効です， 


mode 

モードの内容 

0 

16 X 16 

1 

偶数番目のドットを表示 

2 

奇数番 H のドットを表示 


VOID glocate ( x , y ) 

NAT x , y ; 
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cjastx , cJasty にそれぞれ x ， y を代入します. 

VOID setpg ( dsppag , actpag ) 

TINY dsppag,actpag : 

VRAM の表示ページと書き込みページの設定を行います. dsppag に表示ページ番号 ， actpag 
にアクティブページを指定します.戻り値はありません. 

無効なページ番号を指定したとか， MSX 上で実行した場合の動作は保証されません.実際に切 
り替え可能なページは以下のとおりです. 


画面モード 

VRAM 64 K マシン 

VRAM 1 沈 K マシン 

5 

0 から1ベージ 

0から3ページ 

6 

0から1ベージ 

0から3ベージ 

7 

使用不能 

0から1ページ 

8 

使用不能 

0から1ベージ 


厂使用例 I 

# include <sidio.h> 

# include <g1ib,h> 

/* 表示 ページの みを 1 に変更し，アクティブ ページは 変えない */ 
VOID funclO 
{ 

setpg((TI NY)1 , c ： apagrO ； 

} 


NAT vramsIzeO 

VRAM のサイズを返す関数です.今の所 MSX なら16を， VRAM 64 K の MSX 2 なら64を， 
VRAM 128 K の MSX 2 なら128を返します. 


[ 使用例丨 

# include <$ tdio . h > 

# include < g 1 ib . h > 

/* VRAM サイズのチェック 
VOID chk sizeO 
{ 

if ( vramsize () < 128) { 

printf( w I need at I east 128 K bytes of VRAM to runYn M )； 
exit ( l )； 
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4.1 数値演算関数パッケージの概要 _ 

現在の MSX-C によってサポートされる数値型は整数型と文字型のみとなっています. しか 
し，本格的な MSX-DOS 上でのユーティリティの作成や一般的なプログラムの高速化のために 
MSX-C を利用する場合には，やはり！ 5 桁以上の有効桁数や浮動小数による演算が必要となって 
きます，それを C 言語によって実現しようとすると，手間やソースコードが急激に増大してしま 
い，実現をあきらめたり，他の処理系で行うことになってしまいました.そのようなことをプロ 
グラム作成者が意識せずにあたかも新しい数値型があるようにサポートするためのものが数値演 
算関数パッケージです. 

数値演算関数パッケージでは 4 バイト整数型 (Long 型）と MSX-BAS1C とおなじ倍精度実数 
型 (double 型)の 2 種類をサポートしています. 

4 バイト整数型は整数型の倍の有効桁数 (9 桁)ですので大抵のユーティリティはこれで十分で 
しょう.サポートされる演算は四則，剰余，比較，論理演算，シフト•ローテイトです. 

もう一つの型，倍精度実数型は唯一•の実数型で，演算は有効桁数 14 桁の BCD によって行われ 
ます.サポートされる演算•関数は四則，べき乗，三角関数，指数•対数関数などです. 

以上の他に従来の整数型との変換関数や， 4 バイト整数型と倍精度実数型の変換関数が用意さ 
れています•また，新たに供給された関数の他に書式付き入出力関数 (scanfO ,prmtf 0 など)が 4 
バイト整数型と倍精度実数型の入出力のために拡張されています.. 


4. S 数値演算関数パッケージの使用法 _ 

数値演算関数パッケージを利用するには専用のへッダファイル (math.h) をプログラムの先頭 
でイ ンクルー ドしなければなりません.普通は標準 ヘッダ ファイル (stdio.h) の次でイ ンクルー ド 
します.だいたい次のようになります. 

林 include <stdio.h> 

林 include <math.h> 

/* 1度のラジアンを計算 

mainO 

{ 

XDOUBLE pi, kl80 ； 

XOOUBLE deg ； 
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atoxd ( Spi , ”3.14159265^”）； 
atoxd (& kl 80, ”180”）； 

xddiv (& deg , & pi , & kl 80)； /* deg = pi /180; */ 

printf( M l deg = %f radYn ”， & deg )； 

} 

ヘッダを読み込めばあとは，従来どおりのコーディングができます.コンパイル•リンク手順に 
ついては，本パッケージの他のモジュールと同様に行えます. 


4.3 各数値型の詳細 _ 

ここでは4バイト整数型(以下 Long 型）と倍精度実数型のそれぞれについて詳細を示します. 

4.3.1 型の定義 


A ) Long 型の定義 

Long 型は符号付き Long 型の1種類で符号無し Long 型は存在しません.しかし，入出力にお 
いてサポートされていますので少し注意することで符号無し Long 型のように扱えます•（これに 
ついては「4.3.3定数代入関数」，「4.3.7書式付き入出力関数の拡張」を参照して下さい.）符 
号付き Long 型の定義は次のようになります. 

使用する領域は4バイトで，1バイト目を値の最下位，4バイト目を値の最上位とします.符号 
は4バイト目の第7ビツトとし，2の補数表現とします. MSX - C 上では，次のように型を定義し 
ています.（この型の定義は数値演算関数パッケージのヘッダファイル math . h に含まれていま 
す.） 


typedef struct { 

char byte [4]； 

} SLONG ； 


B ) 倍精度実麵の定義 

倍精度実数型は MSX - BASIC で使用される BCD 表現の倍精度実数と同じものです.詳しく 
は， MSX - BAS 1 C のリファレンスマニュアルをご覧下さい.倍精度実数型の定義は次のようにな 
ります. 

使用する領域は8バイトで，1バイト目を符号（ビット7> と指数部（ビット0から6)，2バイト 
目から8バイト目を仮数部1桁目から14桁目までとして使用しています. MSX - C 上では，次の 
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ように型を定義しています.（この型の定義は数値演算関数パッケージのヘッダファイルに含まれ 
ています.） 


typedef struct { 

char byte[8 ]； 
} XDOUBLE ； 


4.3, g 変数の宣言 _ _ 

Long 型や倍精度実数型の変数を使用する場合には，他の型と同じ様に使用する前に宣言する 
必要があります.宣言は次のようにします. 


SLONG I ； 
XDOUBLE d ； 


変数の初期化は，外部変数または静的変数の場合可能です.次のようにキャラクタ型の配列と 
して初期化をします.（これについてのもう少し詳しい説明が 4.6. 2 B ) にありますのでそちらも 
ご覧下さい.） 


static 


static 


SLONG I = {0 x 78, 0 x 56, 
SLONG ft ! = {10, 20, 

XDOUBLE d = {0 x 46, 0 x 12, 


XOOUBLE e = {0 x 43, 0 x 10, 


0 x 34, 0 x 12}； /* 外部変数のとき 

30, 40}； /* 静的変数のとき 

0 x 34, 0 x 56, 0 x 78, 0 x 90, 0 x 12, 0 x 34}； 

/* 外部変数のとき 
0, 0, 0, 0, 0, 0}; /* 静的変数のとき 


*/ 

*/ 

*/ 

*/ 


Long 型変数1は16進数で〗2345678を表し， m は10進数で673059850を表します.また，倍 
精度実数型変数 d は123456,78901234を表し， e は100を表します. 


4,3,3 定数代入関数 _ 

10進定数を Long 型変数や倍精度実数型変数に代入するには，定数代入関数を使って文字列を 
数値に変換します. 

SL 0 NG 1； 

XDOUBLE ： d ； 

atosl (& l , ”4980205”）; 
atoxd (& d , ”498.0205”）； 

このようにすることで Long 型変数1には10進数で4980205という数値が代入され，倍精度実数 
型変数 d には 498-0205 という数値が代入されます.このとき atoslO 関数はオーバーフローを無 
視するので符号無し Long 型として代入することもできます.また，10進数以外の定数で代入し 
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た V 、場合には， sscanf 0関数で実現できます. 

4.3.4 変数から変数への代入 _ 

変数から変数への代入は， Long 型どうしや倍精度実数型どうしでないと行えません.型が違う 
場合は変換関数を使用する必要があります.（変換関数については「4.3.8変換関数」を参照し 
て下さい.） 


SLONG I , m ; 

XD 0 UBLE d , e ； 
slcpy (& l , & m )； 
xdcpy (& d , & e )； 

4.3.5 演算関数 

演算関数とは，何かバラメータを与えると演算結果を返すものを指します.この場合，四則演 
算も演算関数に含まれます.演算結果はユーザによって指定された領域に格納され，関数値とし 
ては返されません.関数値としては Long 型の場合は演算結果へのポインタが,倍精度実数型の場 
合は演算結果の状態が STATUS 型で返されます. 

オーバーフローなどの演算結果について Long 型はエラー情報を返しませんので注意して下さ 
い.しかし倍精度実数型についてはエラーが発生したかどうかを （0 K または ERROR で)返しま 
すから，必要であればチェックを行って下さい. 


SL 0 NG 丨， m ， 
XDOUBLE d , e , 

n ; 

f ； 

/* 

何か別の処理 

*/ 

sladd (& l , & m , 

in )； 

/* 

1 = m + n ; 

Long 型で和を求める.*/ 



/* 

d = e 氺 f ， 

倍精度実数型で積を求める.*/ 


if ( xdmul (& d , & e , Xf ) == ERROR ) { 

fprintf ( stderr , ’’Math pack errorVn ,t )； 
exit ⑴； 

} 

パラメータの説明をしましよう.第1パラメータは，演算結果を返す変数へのポインタです. 
第2パラメータ，それからあれば第3パラメータは演算の対象となる変数へのポインタです.こ 
れらのパラメータの順は，式で表現した場合と同じようになっています.また，第3バラメータ 
は整数を指定する関数もありますので注意して下さい. 

パラメータの変数どうしが重なっていても正常に動作しますので，不要な変数を持つ必要があ 
りません.つまり， sladd (& l .& l ,& l ) :とすることで Long 型変数1は 2 倍になり， xdsub (& 


/氺 1 = m ; Long 型の場合 */ 

/ * d = e ;倍精度実数型の場合 * / 
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d ，& d ,& d ) :とすることで，倍精度実数型変数 d は0に初期化することができます„ 

2つの型のうち， Long 型の演算関数はほとんどが演算結果へのボインタを返すので次のような 
ことができます. 


SLONG a , b ， c ; 

shall (& c , atol (& a , ”9 ⑽8”）， at .() l (& b ， ”】985 ，，））； 

この記述は c =( a =9938)* ( b =1985) ;と同じことを Long 型で行います. 


4.3.6 比較関数 _ 

比較関数は，〗つの変数値とゼロまたは2つの変数値を上匕較してその結果を整数値の-1,0,1の 
どれかで返すものです.パラメータは Long 型か倍精度実数型へのボインタで，関数値は整数型で 
す.関数値が整数ですので条件式の必要な場所に直接記述することができます. 


SL 0 NG 丨， m ; 
XDOUBLE d ； 


if ( slcmp ( Xl , & ifl ) > 0) { 
} else { 


/* 何か別の処理 */ 

/* 1> m のときの処理 */ 
/* 1 <= m のときの処理 */ 


while ( xdsgn ( d ) > 0) { 


/* d > 0のときの処理*/ 


4.3.7 書式付き入出力関数の拡張 


A ) Long 型の書式付き入出力について 

Long 型を書式付きで入力するには scanfOWl 数中で， int 型を入力するための％ d の代わりに 
% Id を指定します.他の％ x , % 〇, ％ u も同様に％ lx , %1〇, ％ lu , と指定することができます.格 
納先を示す引き数は int 型などと同じで Long 型へのポインタを指定します. 

Long 型を沓式付きで出力するには printfO 関数中で， int 型を出力するための％ d の代わりに 
% Id を指定します.他の％ X ，％ 〇，％ u も同様にできます.また，対応する値には変数そのもの 
ではなく， Long 型変数へのポインタを渡します. 
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int i ； 

SLONG I ; 

scanf (，’ W %\d 9 \ fci, «1 )； 

printf(”integer:%d long:%ld¥n ”， i ， SI 


B ) 倍精度実数型の書式付ぎ入出力について 

倍精度実数型を書式付きで入力するには scanf () 関数中で， int 型を入力するための％ d の代わ 
りに％ f または％ e を指定します. ％ f ， ％ e どちらを指定した場合にも固定小数点，浮動小数点 
の両方の方式で入力することができます.ただし，空白で区切るという制限がありますので注意 
して下さい.格納先を示す引き数は int 型などのときと同じで倍精度実数型へのポインタを指定 
します. 

倍精度実数型を書式付きで出力するには printfO 関数中で， int 型を出力するための％ d の代わ 
りに％ f または％ e を指定します.％ f が指定された場合には固定小数点方式で，％ e が指定され 
た場合には浮動小数点方式で表示されます.また，対応する値には変数そのものではなく，倍精 
度実数型変数へのポインタを渡します. 

int i ; 

XDOUBLE f ； 

scanf (Id % f 9 \ Xi , & f )； 

printf ( J , inte ^ erl^d double :3 if ¥ n ’’， i , Sf )； 

A )， B ) と従来の型をまとめると使用可能なものは次のような表になります. 



scanf 0 

printf 0 

int 

% d ,% x,%o 

% d , % x , % o 

unsigned 

% U,% X,% 0 

% u,% X,% 0 

char 

%c 

%c 

string (char *) 

%s 

%s 

long ( SLONG ) 

% Id , % lx , % lo 

% ld ,% lx,%lo 

unsigned long 
( SLONG 入出力のみ） 

% lu ,% lx , % lo 

% lu ，％ lx，％lo 

double ( XDOUBLE ) 

% f,%e 

% f，％e 
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4.3 •日変換関数 _ 

変換関数は頻度の高い型変換を直接行うための関数です.ですから，ある型からある型への変 
換関数が必ず存在するわけではありません.また，定数代入関数も変換関数の一部と考えること 
ができます. 

下の表では scanf (), printf () を含めて1関数で変換可能なもの，変換不要なものを示します. 


表 変換可能な型 

(関数または=のとき直接変換可能， No のとき直接変換不可能) 


type 

src type 

int 

unsigned 

char 

string 

long 

unsigned 

long 

double 

int 

= 

= 

= 

sprintfO 

itosl 0 


itoxdO 

unsigned 

二 

= 

= 

sprintfO 

uitoslO 


No 

char 

= 


二 

sprintf 0 



No 

string (char *) 

atoiO 




atosl 0 

atosl 0 

atoxdO 

long ( SLONG ) 

No 




slcpyO 

slcpyO 

sltoxdO 

unsigned long 

No 

No 

No 

sprintf () 

slcpyO 

slcpyO 

ultoxdO 

double 

( XDOUBLE ) 

xdtoi 0 

No 

No 

sprintfO 

xdtosl 0 

No 

xdcpyO 


「二」がある変換は直接代入またはキャストによって変換できます.関数名がある変換はその 
関数によって変換ができます. 「 Noj と表示されているものに関しては1度 sprintfO でストリン 
グに変換してから， sscanfO や定数代入関数を使って再度変換することで実現できます.また，長 
さが違いますが内部表現が同じである long から int や unsigned への変換はキャストを使うこと 
でできます.（例： i=*(int *)&1: ) 


4.4 数値演算関数一覧 


定数代入関数 


関数名 

用途 

参照ページ 

atosl 

数値を表す文字列を Long 型に変換 

45 

atoxd 

j 数値を表す文字列を倍精度型変数に変換 

45 


42 
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変数から変数への代入 


関数名 

用途 

参照ページ 

slcpy 

Long 型の値を Long 型の変数に代入 

45 

xdcpy 

| 倍精度実数型の値を倍精度実数型の変数に代入 

46 


演算関数 A ) Long 型の演算関数 


関数名 

用途 

参照ページ 

sladd 

Long 型どうしの加算 

46 

slsub 

Long 型どうしの減算 

46 

slmul 

Long 型どうしの乗算 

46 

sldiv 

Long 型どうしの除算(符号つき） 

46 

slmod 

Long 型どうしの剰余算(符号つき） 

46 

uldiv 

Long 型どうしの除算(符号なし〉 

47 

ulmod 

Long 型どうしの剰余算(符号なし） 

47 

slneg 

Long 型の数値に- 1 をかけたものを返す 

47 

slabs 

Long 型の絶対値を返す 

47 

slnot 

Long 型をビットごとに反転させる 

47 

sland 

Long 型でビットごとの論理積を求める 

47 

slor 

Long 型でビットごとの論理和を求める 

48 

slxor 

Long 型でビットごとの排他的論理和を求める 

48 

slsla 

Long 型を算術的左シフト行う 

48 

slsll 

Long 型を論理的左シフト行う 

48 

slsra 

Long 型を算術的右シフト行う 

48 

slsrl 

Long 型を論理的右シフト行う 

49 

slrlc 

Long 型を左口ーテイト行う 

49 

slrl 

n 

49 

slrrc 

Long 型を右ローテイト行う 

49 

slrr 

” 

50 


B ) 倍精度実数型の演算関数 


関数名 

用途 

参照ページ 

xdadd 

倍精度実数型どうしの加算 

50 

xdsub 

倍精度実数型どうしの減算 

50 

xdmul 

倍精度実数型どうしの乗算 

50 

xddiv 

倍精度実数型どうしの除算 

50 

xdpow 

倍精度実数型どうしのべき乗を計算する 

51 
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関数名 

用途 

参照ページ 

xdneg 

数値に- 1 をかけたものを返す 

51 

xdfabs 

数値の絶対値を求める 

51 

xdfix 

数値の小数部分を切り捨てる 

51 

xdfloor 

数値を越えない最大の整数を求める 

51 

xdceil 

数値より小さくない最小の整数を求める 

51 

xdsqrt 

倍精度実数型で平方根を計算する 

52 

xdsin 

数値をラジアンとして正弦（サイン）を計算する 

52 

xdcos 

数値をラジアンとして余弦（コサイン）を i 十算する 

52 

xdtan 

数値をラジアンとして正接（タンジェント）を計算する 

52 

xdatn 

数値の逆正接（アークタンジヱント）を計算する 

52 

xcllog 

数値の対数を計算する 

52 

xdexp 

e に対する指数を計算する 

52 

xdrnd 

乱数を発生させる 

53 


比較関数 


関数名 

用途 

参照ページ 

slsgn 

Long 型の符号値を返す 

53 

slcmp 

Long 型どうしで較し結果を返す 

53 

xdsgn 

倍精度実数の符号値を返す 

53 

xdcmp 

倍精度実数型どうしで比較し結果を返す 

54 


変換関数 


関数名 

用途 

参照ページ 

sltoa 

Long 型の数値を文字列に変換する 

54 

itosl 

整数から Long 型に変換する 

54 

uitosl 

符号なし整数から Long 型に変換する 

54 

xcltoa 

倍精度実数型を文字列に変換する 

54 

itoxd 

整数型から倍精度実数型に変換する 

55 

xcUoi 

倍精度実数型から整数型に変換する 

55 

sltoxd 

Long 型から倍精度実数型に変換する 

55 

ultoxcl 

Long 型の値を符号なしとして倍精度実数型に変換する 

55 

xdtosl 

倍精度実数型を Long 型に変換する 

55 



























第 4 # 数値演算関数パッケージ 


4.5 数値演算関数リファレンス 


4.5.1 定数代入関数 


SLONG *atosl ( ans 7 s ) 

SLONG *ans : 
char 木 s ; 

数値を衷す文字列を変換して Long 型変数に代入します.関数値としては，第1バラメータと同 
じものが返されます. 

STATUS atoxdCans ^ s ) 

XDOUBLE *ans : 
char *s ’• 

数値を表す文字列を変換して倍精度実数型変数に代入します，関数値としては，変換が成功し 
たかの ステータスが 返されます. 


4.5. S 変数から変数への代入 _ 

SLONG *slcpy ( ans ^ pl ) 

SLONG * ans ；* pl ； 

pi で示される Long 型変数の値が ans で示される Long 型の変数に代入されます.つまり， 
*ans = * pl ;なることを Long 型で行います. 

XDOUBLE * xdcpy ( ans , pl ) 

XDOUBLE * ans , * pl ; 

Pi で示される倍精度実数型の値が. ans で示される倍精度実数型の変数に代入されます. 

4.5.3 演算関数 


A ) Long 型の演算関数 


45 




SLONG * sladd ( ans , pl , p 2) 
SLONG * ans , * pl ,* p 2 ; 


Long 型どうしで加算を行います.つまり， * ans = * pl + * p 2 ； 

す. 

SLONG * slsub ( ans,pl , p 2) 

SLONG * ans , * pl ,* p 2 ; 

Long 型どうしで減算を行います，つまり， * ans = * pl —* p 2 : 

す. 

SLONG * slmul ( ans / pl , p 2) 

SLONG * ans , *pl f * p 2 ; 

Long 型どうしで乗算を行います，つまり， * ans = * pl * * p 2 ; 

す. 

SLONG * sldiv ( ans , pl , p 2) 

SLONG * ans , * pl ,* p 2 : 

Long 型どうしで除算を行 V >ます_つまり， * ans 二 * pl /* p 2 ; 
す.この関数は符号つき Long 型を想定しています. 

SLONG *slmod ( ans.pl , p 2) 

SLONG * ans , * pl ,* p 2 ; 

Long 型どうしの剰余を計算します.つまり， * ans =* pl %* p 2; 
ます.この関数は符号つき Long 型を想定しています. 

SLONG *uldi v ( ans , pi , p 2) 

SLONG * ans , * pl ,* p 2 ; 

Long 型どうしで除算を行います.つまり ， *ans = * pl /* p 2 ; 
す.この関数は符号無し Long 型を想定しています. 

SLONG * ulmod ( ans,pl , p 2) 

SLONG * ans , * pl ,* p 2 ； 


なる計算を Long 型で行いま 


なる計算を Long 型で行いま 


なる計算を Long 型で行いま 


なる計算を Lcmg 型で行いま 


一 

なる計算を Long 型で行い 


なる計算を Long 型で行いま 
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Long 型どうしの剰余を計算します.つまり， *ans=*pl %*p2 :なる計算を Long 型で行い 
ます.この関数は符号無し Long 型を想定しています. 

SLONG *slneg(ans / pl) 

SLONG *ans, *pl ; 

Long 型の数値に一 1 をかけたものを ans に返します. *ans= —*pl :と同じ事を Long 型で 
行います.数値がマイナスの最大値一 2147483648 であった場合には変化がありません . ans と pi 
が同じであった場合は，指定された変数の値に一1がかけられます. 


SLONG *slabs (ans # pl) 

SLONG *ans, *pl ； 

Long 型の絶対値を ans に返します. *ans 二 abs(*pl)i と同じ事を Long 型で行います.数 
値がマイナスの最大値一 2147483648 であった場合には変化がありません. 

SLONG *slnot (ans,pi) 

SLONG *ans,*pl; 


Long 型をビットごとに反転させます•つまり， *ans= ~ *pl ;なる計算を Long 型で行いま 
す. 

SLONG *sland (ans , pi , p2) 

SLONG *ans, *pl,*p2 ; 

Long 型でビットごとの論理積を求めます.つまり， *ans= *pl&*p2 ;なる計算を Long 型 
で行います. 

SLONG *slor(ans / pl / p2) 

SLONG *ans, *pl, 氺 p2 ; 

Long 型でビットごとの論理和を求めます•つまり， *ans= *pl ! *p2 :なる計算を LonR 型 
で行います. 

SLONG *slxor(ans,pl ,p2) 

SLONG *ans, *pl,*p2 ; 

Long 型でビットごとの排他的論理和を求めます.つまり， *ans= *pl ^ *p2 :なる計算を 

4フ 



Long 型で行います. 


SLONG * slsla ( ans f pl , k ) 

SLONG * ans , * pl ; 

TINY k ; 

Long 型を k ビット算術的左シフト行います，つまり， * ans = * pl « k :なる計算を Long 
型で行います.最後に追い出されたビットは BOOL slcy に格納されます.この関数はオーバーフ 
ローを 考えません. 


slcy — |_31―_ *pi _卜 _ 0 


SLONG * slsll ( ans , pl , k ) 

SLONG * ans , * pl ; 

TINY k : 

Long 型を k ビット論理的左シフト行います.つまり， * ans = * pl « k i なる計算を Long 
型で行います.最後に追い出されたビットは BOOL slcy に格納されます.この関数は slsla () と 
全く同じ動作をします. 


slcy <- |_ 31 ——_* d 1 —卜 〇」 — 〇 


SLONG *slsra ( ans , p 1, k ) 

SLONG * ans ,* pl ; 

TINY k ； 

Long 型を k ビット算術的右シフト行います•つまり，符号ビットを保存しながら * ans = * pl » 
k ;なる計算を Long 型で行います.最後に追い出されたビットは BOOL slcy に格納されま 
す.この関数はオーバーフローを考えません. 



slcy 


SLONG *slsrl ( ans , pi , k ) 

SLONG * ans , * pl ； 

TINY k ; 

Long 型を k ビット論理的右シフト行います-つまり， * ans = * pl»k : 
で行います.最後に追い出されたビットは BOOL slcy に格納されます. 
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なる計算を Long 型 
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31 —* pl 0 」 —slcy 


SLONG * slrlc ( ans , pl , k ) 
SLONG * ans ,* pl ; 

TINY k ； 


Long 型を k ビット左ローテイトを行います.ビット31から追い出されたビットはビット0に 
移ります.最後に追い出されたビット31は BOOL slcy に格納されます. 


slcy 



31— 






SLONG *slrl ( ans . pl , k ) 

SLONG * ans , * pl ; 

TINY k ; 

Long 型を k ビット左ローテイトを行います.ビット31から追い出されたビットは BOOL 
slcy に格納され， slcy はビット0に移ります.最後に追い出されたビット31が BOOL slcy に格 
納されます. 



SLONG * slrrc ( ans , pl , k ) 

SLONG * ans ,* pl ; 

TINY k ; 

Long 型を k ビット右ローテイトを行います♦ビット0から追い出されたビットはビット31に 
移ります.最後に追い出されたビット0は BOOL slcy に格納されます. 



SLONG * slrr ( ans , pl , k ) 

SLONG * ans ,* pl ; 

TINY k ; 

Long 型を k ビツト右ローテイトを行います•ビット0から追い出されたビットは BOOL slcy 
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に格納され， slcy はビット31に移ります.最後に追い出されたビット0が BOOL slcy に格納さ 
れます， 



B ) 倍精度実数型の演算関数 


ST ATUS xdadd (ans , pl , p 2) 

XDOUBLE * ans , * pl ,* p 2 ; 

倍精度実数型どうしの加算を行います.つまり， * ans =* pl +* p 2 :なる計算を倍精度実数型 
で行います. 

STATUS xdsub ( ans,pl , p 2) 

XDOUBLE * ans , * pl ,* p 2 ; 

倍精度実数型どうしの減算を行います.つまり， * ans = * pl - * p 2 :なる計算を倍精度実数型 
で行います. 

STATUS xdmul ( ans,pl , p 2) 

XDOUBLE * ans , * pl ,* p 2 ; 

倍精度実数型どうしの乗算を行います.つまり， * ans = * *|〕2 ;なる計算を倍精度実数 
型で行います. 

STATUS xddiv ( ans , pl f p 2) 

XDOUBLE * ans , * pl ,* p 2 ; 

倍精度実数型どうしの除算を行います.つまり，氺 ans =* pl /* p 2 ;なる計算を倍精度実数型 
で行います. 

STATUS xdpow ( ans.pl , p 2) 

XDOUBLE * ans , * pl ,* p 2 ； 

倍精度実数型のべき乗を計算します.つまり， * ans = pow (* pl ，* p 2〉 ；なる計算を倍精度実 
数型で行います. 

STATUS xdneg ( ans , pl ) 


50 




第 4 章数値演箅關数パッケージ 


XDOUBLE * ans , * pl : 

数値に一 1 を掛けたものを返します.つまり， *ans=_*pl ;なる計算を倍精度実数型で行い 
ます. 

STATUS xdfabs ( ans , pl ) 

XDOUBLE * ans ,* pl ; 

数値の絶対値を求めます.つまり， *ans=fabs(*pl) ;なる計算を倍精度実数型で行いま 
す. 

STATUS xdfix ( ans . pl ) 

XDOUBLE * ans , * pl ; 

数値の小数部分を切り捨てます. MSX-BASIC の FIX 関数と同じ事を倍精度実数型で行いま 
す.つまり，数値のゼロよりの整数を求めます. 

STATUS xdfloor ( ans , pl ) 

XDOUBLE 氺 ans , * pl ； 

数値を超えない最大の整数を求めます.つまり， *ans=floor(*pl) :なる計算を倍精度実数 
型で行います. 

STATUS xdceil ( ans , pl ) 

XDOUBLE * ans , 印1; 

数値より小さくない最小の整数を求めます.つまり， *ans-ceil(*pl) :なる計算を倍精度実 
数型で行います. 

STATUS xdsqrt ( ans , pl ) 

XDOUBLE * ans , * pl ; 

倍精度実数型で平方根を計算します•つまり， * ans = sqrt (* pl ) ;なる計算を倍精度実数型で 
行います. 

STATUS xdsin ( ans , pl ) 

XDOUBLE * ans , * pl ； 

数値をラジアンとして正弦（サイン）を計算します • つまり， * ans = sin (* pl ) :なる計算を倍 
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精度実数型で行います. 


ST ATUS xdcos ( ans , p 1〉 

XDOUBLE * ans , * pl ; 

数値をラジアンとして余弦（コサイン）を計算します.つまり， * ans = cos (* pl ) :なる計算を 
倍精度実数型で行います. 

STATUS xdtan (ans , pl ) 

XDOUBLE * ans f * pl ; 

数値をラジアンとして正接（タンジェント）を計算します•つまり， * ans = tan (* pl ) :なる計 
算を倍精度実数型で行います. 

STATUS xdatn ( ans , pl ) 

XDOUBLE * ans , * pl ; 

数値の逆正接（アークタンジェント）を計算します.つまり， * ans = atan (* pl ) ;なる計算を 
倍精度実数型で行います. 

STATUS xdlog ( ans , pl ) 

XDOUBLE * ans , * pl ; 

数値の対数を計算します.つまり， * ans = log (* pl ) :なる計算を倍精度実数型で行います. 

ST ATUS xdexp ( ans , pi ) 

XDOUBLE * ans , 氺 pi ; 

e に対する指数を計算します.つまり， *ans=exp(* p i) :なる計算を倍精度実数型で行いま 
す. 

STATUS xdrnd ( ans , pi ) 

XDOUBLE * ans , * pl ; 

0 から 1 までの乱数を得ます. *pl < 0の場合は乱数系列の初期化を行い， *pl = 0 の場合は前 
回の値を返し， * pl > 0の場合は次の乱数を発生させそれを返します. 
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int xdsgn(pl) 

XDOUBLE *pl ; 

指定された倍糟度実数の符号値を返します.結果は下に示します. 

xdsgn () 


4.5.4 比較関数 


int slsgn (pi) 

SLONG *pl; 

指定された Long 型の符号値を返します.結果は下に示します. 

_ slsgn 0 


*pl > 0 

なら 

1 

* pl = 0 

なら 

0 

*pl < 0 

なら 

-1 


int slcmp(pl / p2) 

SLONG *pl,*p2; 


Long 型どうしで比較を行い，その結果を下に示すように返します. 

slcmpO 


ららら 

ななな 


32g )2 
*p*p*p 


IX IX 
p p p 


*pl > 0 


なら 



int xdcmp ( pl / p 2) 

XDOUBLE * pl ,* p 2 : 

倍精度実数型どうしで比較を行い，その結果を下に示すように返します. 

_ xdcmpO 


char 

ホ sltoa ( s , l , radix ) 

char 

*s ; 

SLONG 

*1 ; 

TINY 

radix ； 


Long 型の数値を radix 進数として文字列に変換したものを s で示される領域に格納し， s を返 
します. radix のビット7が立っている場合には符号なしの数値として扱います. 

SLONG * itosl ( ans , i ) 

SLONG *ans ； 
int i ； 

整数から Long 型に変換します.このとき符号の拡張が行われます. 

SLONG * uitosl ( ans , ui ) 

SLONG *ans ; 
unsigned ui ； 

符号無し整数から Long 型に変換します.もともと符号はありませんから，拡張は行われませ 
ん. 

char 氺 xdtoa ( s , d , digits ) 
char *s ； 

XDOUBLE *d ; 

TINY digits ; 


ななな 


2 2 2 
*p*p*p 

> 一一く 
IX 1A IX 
*p*p*p 


数 

0 


5 

5 . 

鏖 

4 
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倍精度実数型の数値を文字列として変換したものを s で示される領域に格納し， s を返します. 
digits で小数点以下の桁数を指定します. digits のビット7が立っていない場合は固定小数点形 
式で，立っている場合は浮動小数点形式に変換します- 

STATUS itoxd ( dj ) 

XDOUBLE *d ; 
int i ; 

整数型から倍精度実数型に変換します. 


STATUS xdtoi ( i ' d ) 
int *i : 

XDOUBLE *d : 

倍精度実数型から整数型に変換します.小数点以下は切り捨てられ，変換された数値が整数の 
範囲外である場合には関数値として ERROR が返されます • 


STATUS sltoxd ( cU ) 

XDOUBLE *d : 

SLONG *1 ; 

Long 型から倍精度実数型に変換します. 


STATUS ultoxd ( d , ul ) 

XDOUBLE *d : 

SLONG *ul ; 

Long 型の値を符号無しとして倍精度実数型に変換します. 


STATUS xdtosi ( Ld ) 

SLONG *1 ; 

XDOUBLE *d : 

倍精度実数型を Long 型に変換します.小数点以下は切り捨てられます.変換された数値が 
Long 型の範囲外であってもエラーが返されることはありません. 
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4.6数値演算関数を使う上での; mS , 留黯 


4.6.1 使用上の注意点 _ _ 

A ) 倍精度実数型を使用するためにはスタック領域がページ2または3にある必要があります 
(スタック領域に Math - Pack を呼び出すコードを置くため).通常スタック領域は指定のページ 
にありますが，自動変数として非常に大きな配列を宣言するとページ〇または1になる場合があ 
ります. 

B ) Long 型では演算や変換を行ってもその結果の範囲に ついての チェックをしません.これは 
整数型などと同じですが，倍精度実数型から変換する場合には事前に範囲のチ x ックなどをして 
不良動作をしないようにすることをお薦めします. 

C ) 倍精度実数型をアスキー文字列として入出力する場合，その一時バッファとして BUF 
(0 F 55 EH から258バイト）と FBUFFER (0 F 7 C 5 H から43バイト）を使用しますので，この領域 
を使用する場合には十分ご注意下さい. 


4.6,2 テクニッ ^ S _ _ 

A ) 数値演算関数ノ ゞ ッケージを使用する場合にはヘッダ math . h をインクルードしますが，その 
中には scanf () , printf () を拡張するための# define 文があります.これによって scanfO , printf 0 
が置き換えられています.拡張されていない scanf 0 , printf 0を使用したい場合には ，# include 
く math . h 〉 以降の行で# undef printf などとしてください.なおこの場合も拡張された scanfO , 
printf () は mscfO ， mprf () として使用することが出来ます. 

#define printf mprf 
#def ine f pr intf inf prf 
林 define sprintf msprf 
搞 define scanf mscf 
ttdefine fscanf mfscf 
fidetine sscanf msscf 

( math . h より抜粋） 


また，本パツケージライブラリファイルには Long 型，倍精度実数型の両方を一度に利用するこ 
とができるように scanfO , printf 0が拡張されています.しかし，ソースファイル prsc . c の# 
include く math . h > の前でコンパイルスイツチ NOUSESL または NOUSEXD を定義し，リコン 
パイルすることで Long 型，倍精度実数型のそれぞれを使わないライブラリが作成できます.新た 


56 




第 4 章数値演算関数ノぐ：/ケージ 


に作成されたライブラリを使用する場合には，アプリケーションプログラムでは，# include 
〈 math . h > の前でコンパイルスイッチ NOUSESL または NOUSEXD を定義し，リンク時，新た 
なライブラリをリンクする必要があります. 

CW 1 倍精度実数型を使用しない例 


define NOUSEXD /* 倍精度実数型を使用しない宣言 */ 

/* この行をいれてコンパイルした prsc . c のリロケータブルオブジェクトモジュール 
も必要です. 

必ず math • h の前にいれてコンパイルして下さい • 

Long 型を使用しない場合は# define NOUSESL とする. 

*/ 

# include <math.h> 
main () 



B ) ブログラムの作成には初期化というものは重要なものです.初期化には定数代入関数を使用 
してもいいのですが，それだとどうしてもオブジェクトサイズが大きくなってしまいます.ここ 


では Long 型を中心に別の初期化方法について紹介します. 


Long 型を 0 に初期化したい場合にはキャストを利用して次のようにすると効率的です. 
t((int *)&longvar+l) = ^(int i：)Slongvar = 0 ； 

一 1 に初期化したい場合には 0 の代わりに一1を指定すればできます. 

Lo 叩型を 0 に初期化した後は char 型からロングへの変換が簡単にできます， 

孚 （（int t)Slongvar+l) = ^(ini ^)&longvar = 0 ； 

Ion^var.byte[0] = charvar ； 

静的な（変数宣言時の）初期化についても述べましょう.変数の宣言時には単なる配列のように 
初期化ができます. 

SLONG longvar = {0x10, 0x27, 0, 0 }； /* longvar= 10000 ； */ 

X DOUBLE dblvar = {0x43, 0x36, 0x52, 0x42, 0x20, 0, 0, 0}; 

/ * dblvar=365.2422 : * / 

Long 型の初期化のためのデータは MSX-BASIC で次のようなプログラムを実行させれば簡単 
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に作成できます, 


求めたい値を代入しておく 
Long 型は4バイト 
1バイトを10進数で表示 
次のパイトのための準備 


倍精度実数型の初期化のためのデータも次のようにできます 


100 A#=10000 
110 FOR 1=1 TO 4 

120 PRINT AlMNT(A#/256) ポ 256; 
130 A#=INT(A#/256) 

140 NEXT 


100 A#=365.2422 
110 l=VARPTR(A#) 

120 FOR J=l TO 1+7 
130 PRINT PEFK(J )； 

MO NEXT 


’求めたい値を代入しておく 
’格納位置を求める 
’倍精度実数型は全部で8バイト 
’1バイトを10進数で表示 


内部の表現がわかつている場合には変数宣言時以外にも，各型のメンバに代入することで動的 
に初期化ができます. 


/* Iongvar = 10000 : */ 

Iongvar . byte [0] = ( char ) OxlO ； 
longvar . byieCl ]=( char )0 x 27； 

本 （（int I)&1ongvar +1)=0 ； 

C ) slbuf ， slcy について 

数値演算関数ノ { ツ ケージには slbuf , slcy という外部変数が宣言されています. 
slbuf は一時的な演算結果の格納に使います.使用す るには 演算関数などの結果格納の指定(第 
1パラメータ）に NULL ポインタを指定します•すると関数値として slbuf へのポインタが返さ 
れます.演算結果は使うがいつまでもとっておく必要がない場合に使うと便利です.例えば 

printf(” ％ ld¥n” ， sladd(NLJLL, &a, Sb ))； 

とすれば不要な変数を宣言せずに Long 型変数 a と1〕の和を表示することができます. NULL の 
代わりに ERROR を指定しても同様なことができます.この場合 NULL とは使用される領域が 
異なります. 

slcy はシフト•ロー テイ ト 関数使用時に キヤリーフ ラグとして動作します. つまりシフ トや 口 
ー テイ トを した後変数から追い出されたビツトの状態がこの変数に入ります. ユーザは 自由にこ 
の変数を参照したり，変更す る ことができます，ただし ， slcy は BOOL 型変数なので YES また 
は NO のいずれかの値しか代入することができません.また，論理演算関数を行っても NO にな 
ることはありません. 

slbuf , slcy はどちらも Long 型専用のもので倍精度実数型の関数では使用することはできませ 
ん. 
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第5章その他の関数 


5.1 その他の関数の概要 _ 

ここでは関数を以下の3つに分類してその概要を解説します. 

• スロットを管理する関数 
• BIOS を呼ぶ関数 
• その他 

5.1.1 スロットを管理する関数 _ 

スロッ ト間での関数呼び出しをおこなったり， ROM - BIOS 内のルーチンをコールするための 
関数などが用意されています. 

これらの関数を用いる予備知識としての MSX のスロットという概念や， ROM - BIOS や ROM 
- BASIC などについては 「 MSX 2 テクニカルハンドブック」等をご参照下さい. 

5.1.2 BOS を呼ぶ関数 _ 

MSX 本体に内蔵された ROM には数多くの MSX の基本的な入出力を扱うルーチンが含まれ 
ています，これらの入出カルーチンを総称して BIOS (Basic I/O System ) と呼びます. 

アプリケーションプログラムでは MSX の各機種間での差異を吸収するために入出力はこの 
BIOS を介して行うことが推奨されています.しかし，これまでは C のプログラムだけで BIOS ル 
ーチンを呼び出すためには標準ライブラリ関数の biosO や bioshO などの汎用的な関数を用いる 
しかなく C プログラマにとっては BIOS - ROM 内のルーチンを積極的に用いることができる環 
境ではありませんでした.そこで BIOS ルーチンの中でも必要性の髙いものを個別に C の関数呼 
び出しの形で用いることができるようにしたのが BIOS を呼ぶ関数群です. 

BIOS ルーチンでここではサボートされてないものを用いたし、場合は上のスロットを管理する 
関数の calbioO などを用いることができます. 

5.1.3 その他の関数 _ 

その他に乱数を発生する関数， MSX のバージョンを獲得する関数，割り込みめ禁止，許可を行 
う関数などがあります. 
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5. E その他の関数の使用法 _ 

本章で解説する関数の宣言は msxbios . h のなかで宣言されています.ソースファイルの中でイ 
ンクルードが必要です.また，グラフィック関数を併せて用いる場合で， glib.h のインクルード 
を行つている場合にはこのなかで msxbios.h のインクルードがおこなわれているため，格別にこ 
れをインクルードする必要はありません. 

コンバイルは通常どおりにおこない，リンク時には inlib.rel をリンクしてください.パラメー 
タチェックには mlib.tco をパラメータとしてあたえます.コンバイル，パラメータ チェック， リ 
ンクの手順は msxc.bat というバッチにまとめられています. 


5.3 その他の関数一覧 


スロットを管理する関数 


関数名 

用途 

参照ページ 

calbio 

ROM-BIOS のアドレスをコールする 

62 

calbas 

)) 

62 

calsub 

SUB-ROM のアドレスをコールする 

62 

calslt 

指定のスロットのアドレスをコールする 

63 

rdslt 

スロットのアドレスの内容を返す 

63 

wrslt 

スロットのアドレスにデータを書き込む 

63 

callx 

現在表にでているスロットのアドレスをコールする 

63 


1 注意 1 * の付いた関数は割り込みフラダを変化させません.それ以外の関数は「割り込み許可」 
で返ってきます. 
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BIOS を呼ぶ関数 


関数名 

用途 

参照ページ 

inifnk 

ファンクションキーの内容をデフォルトに戻す 

64 

disscr 

スクリーンの表示の禁止 

64 

enascr 

スクリーンの表示の許可 

64 

screen 

スクリーンモードの変更 

64 

gicini 

PSG の初期化 

64 

sound 

P SG のレジスタにデータを書き込む 

64 

rdpsg 

PSG の指定されたレジスタの内容を返す 

65 

chsns 

キーボードからの入力があるかどうかの判定 

65 

chget 

キーボードからの一文字入力 

65 

chput 

テキストスクリーンへの一文字出力 

65 

Iptout 

ブリンタへの一文字出力 

65 

lptstt 

プリンタの準備ができているかどうかの判定 

65 

pinlin 

スクリーンエディタを起動する 

65 

inlin 

// 

66 

break x 

ControI-STOP が押されているかどうかの判定 

66 

beep 

ビープ音の発生 

66 

els 

スクリーンの表示を消す 

66 

locate 

カーソルの位置を指定する 

66 

erafnk 

ファンクションキーの表示を消す 

66 

dspfnk 

ファンクシヨンキーの表示 

66 

gtstek 

ジョイスティックの状態を調べる 

66 

gttrig 

トリガボタンの状態を調べる 

67 

gtpacl 

入出力装匱の状態を調べる 

67 

gtpdl 

パドルの内容を読む 

68 

chgsnd * , 

サウンドポートのオン/オフによる音の発生 

68 

i 

snsmat 

キーマトリクスの彳直を見る 

69 

kilbuf 

キーボードバッファの内容を消去する 

69 


その他 


関数名 

用途 

参照ページ 

rnd * 

ランダムな整数を返す 

69 

di 

割り込みの禁止 

69 

ei 

割り込みの許可 

69 

msx 2 * 

MSX のバージヨンを調べる 

69 

fnkstr * 

フアンクシヨンキーの内容を保持しているエリアへのボインタを返す 

69 
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5.4 その他の関数リファレンス _ 

本節の解説で用いられる変数型はヘッダーファイルのなかで次のように定義されています. 


TINY char 型に定義 ( typedef ) されています. 

NAT unsigned 型に定義されています. 

5.4.1 スロットを管理する関数 


VOID 

calbio (adrs, reg) 

NAT 

adrs ； 

REGS 

*reg ; 


ROM-BIOS の指定されたアドレスをコールします.ルーチンをコールする前に値がポインタ 
で指定されたところから Z 80 のレジスタに〇—ドされ，ルーチンからリターンする際に Z 80 のレ 
ジスタの内容が同じ所にコピーされます， ROM-BIOS だけが.表に出ます. adrs は 0 H から 
3 FFFH の間でなければなりません， 

REGS は msxbios.h の中で以下のように定義されています. 


typedef 


} REGS ； 


struct 

regs { 

TINY 

f ； 

TINY 

a ； 

NAT 

be ； 

NAT 

de; 

NAT 

hi ； 


一 


VOID calbas(adrs.reg) 

NAT adrs ； 

REGS *reg ; 

calbioO とほぼ同じですが， ROM-BIOS と BASIOROM の両方が表に出ます. adrs は 4000 H 
から 7 FFFH の間でなければなりません. 


VOID calsub (adrs , reg) 

NAT adrs ; 
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REGS *reg : 

SUB - ROM の指定されたアドレスをコールします.ルーチンをコールする前に値がボイ ン タで 
指定されたところからレジスタにロードされ，ルーチ ン からリター ン する際にレジスタの内容が 
同じ所にコピーされます. SUB - ROM だけが表に出ます. adrs は 0 H から 3 FFFH の問でなけれ 
ばなりません. 

VOID calslt ( slot , adrs , reg ) 

TINY slot ; 

NAT adrs ； 

REGS *reg ; 

指定されたスロットの指定されたアドレスをコールします.ルーチンをコールする前に値がポ 
インタで指定されたところからレジスタにロー ドされ，ルーチンからリターンする際にレジスタ 
の内容が同じ所にコピーされます. 

指定されたアドレスを含むページだけが表に出ます. 


TINY 

rdslt ( slot , adr ) 

TINY 

slot ; 

NAT 

adr ; 


指定されたスロットの指定されたアドレスの内容を返します. 

VOID wrslt ( slot , adr , value ) 

TINY slot : 

NAT adr : 

TINY value : 


指定されたスロットの指定されたアドレスに，データを書き込みます. 


VOID 

callx ( adrs , reg ) 

NAT 

adrs ； 

REGS 

氺 reg ; 


現在選択されている スロッ トの指定されたアドレスをコールします.ルーチンを コールす る前 
に値がポインタで指定されたところから Z 80 のレジスタにロー ドされルーチンからリターンす 
る際に Z 80 のレジスタの内容が同じところにコピーされます•この関数は通常のアドレスをコー 
ルする ための も のですが， MSX - DOS の環境では次のような使い方もできます 
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^define BDOS 0x5 
#define GETDATE (NAT)0x2a 


getdate(y, m, d) 

int 本 y, ネ m, 李 d; 

{ 

REGS r ； 

r.bc = GETDATE ； 
callx(BDOS, Sr )； 
ly = r.hl ； 

Im = r.de / 256 ； 
*d = r.de % 256 ； 


5-4.2 BIOS を呼ぶ関数 _ 

VOID inifnkO 

ファ ンクション キーの 内容をデイ フオルト に戻します. 

VOID disscrO 

スクリーンの表示を禁止します. 

VOID enascrO 

スクリーンの表示を許可します. 

VOID screen (mode) 

TINY mode : 

スクリーンモードを変更します.無効なモード （ MSX 上で4から8を指定したなど）に対して 
の動作は保証されません. 

なお，スクリーンモードについては， MSX - BASIC のマニュアルを御参照下さい. 

VOID giciniO 

PSG を初期化します. 
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VOID 

sound (reg, val) 

TINY 

reg ； 

TINY 

val ； 


PSG のレジスタにデータを書き込みます. 

reg で PSG レジスタ， val で出カデータを指定します. PSG のデータについての詳細は MSX 
- BASIC の SOUND 文についての解説や， 「 MSX 2 テクニカルハンドブック」等をご覧下さ 

い. 

TINY rdpsg (reg) 

TINY reg ; 

PSG の指定されたレジスタの内容を返します. 

BOOL chsnsO 

キーボードからの入力があれば1を，なければ〇を返します. 

char chgetO 

キーボードから1文字入力します， 

VOID chput(c) 

char c ； 

テキストスクリーンに 1 文字出力します. 

BOOL Iptout(c) 

char c ; 

プリンタに 1 文字出力します.出力に成功すれば1を， Contro 卜 STOP で中断されれば〇を返 
します. 

BOOL IptsttO 

プリンタが READY であるなら1を，そうでないなら〇を返します 


char 


氺 pinlin() 
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スクリーンエディタを起動します.キャリッジリターンが押されるとその時点で力ーソルがあ 
つた行の内容へのボインタを返します. Contro 卜 STOP か Contro 卜 C が押されると NULL への 
ポインタが返されます. pinlin を呼んだときの力ーソルの X 座標にかかわらず，常に行の先頭か 
らの内容を返します. 

char *inlin() 

pinlin とほぼ同じですが inlin を呼んだ時のカーソルの X 座標以降の内容しか返しません.た 
だしカーソルの Y 座標が変わつたときは行の先頭からの内容を返します.プロンプトメッセージ 
を伴つた入力の時に便利です. 


BOOL breakxO 


Contro 卜 STOP が押されていれば1を，そうでなければ0を返します. 


VOID beepO 

ビープ音を発生します. 

VOID cls() 

スクリーンの表示を消します.テキストスクリーンでもグラフィックスクリーンでも有効です. 

VOID locate (csrx, csry) 

TINY csrx'csry ; 

テキストカーソルの位 E を指定します. 

VOID erafnkO 

ファンクションキーの 表示を消します. 

VOID dspfnkO 

ファンク シヨ ン キーを表示します. 


TINY gtstck(port) 

TINY port ; 
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ジョイスティックの状態を調べます. 

port で調べたいジョイスティックポートを指定します.ジョイステイックポートと戻り値は次 
のとおり. 


port : 0 カーソルキー 

1 ジョイスティック#1 

2 ジョイスティック#2 

戻り値：方向に応じて0から8が返される. 


BOOL gttrig(trig) 

TINY trig ; 

トリガボタンの状態を調べます. 

trig で調べたいトリガーボタンの番号を指定します.戻り値はトリガーが押されていれば1,さ 
もなければ0が返される. 

トリガボタンの番号と実際の装置との対応は以下のとおり. 


通常時 

0 

1 

2 

3 

4 

スペースキー 

ジョイスティック#1のトリガボタン1 
ショイスティック#2のトリガボタン1 
ショイスティック#1のトリガボタン2 
ショイスティック#2のトリガボタン2 

マウス使用時 

1 

2 

3 

マウス1の左ボタン 
マウス2の左ボタン 
マウス1の右ボタン 

4 

マウス2の右ボタン 


TINY gtpad(pad) 

TINY pad ; 

各種の入出力装 E の状態を調べます.本関数で扱うことのできる装置は，タッチパネル，ライ 
トペン， マウス， トラックボールな どです. 

pad で調べたい装置の ID を与え，戻り値で状態を知ることができます.装置 ID と戻り値の関 
係は以下の通りです. 
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装置 ID 

指定される装置 

返ってくる情報 

0 

タッチバネル1 

パネルに触っていれば 0 FFH ，そうでなければ 00 H 

1 


X 座標 (0 から 255) 

2 


Y 座標 (0 から 255) 

3 


ボタンが押されて V 、れば 0 FFII ，いなければ OOH 

4 

5 

6 

7 

タッチパネル2 

同上 

8 

ライトペン 

0 FFII であればデータ有効. 00 H であれば無効 

9 


X 座標 (0 から 255) 

10 


Y 座標(〇から25 5) 

11 


スイツチが押されていれば 0 FFH ，いなければ 00 H 

12 

マウス1または 

常に 0 FFH を返す(入力要求に用いる） 

13 

トラック ボール 

X 方向の変位 (-128 から 127) 

14 


Y 方向の変位 (-128 から 127) 

15 


常に0011を返す（意味なし） 

16 

マウス2または 

同上 

17 

トラック ボール 


18 



19 




「注意 1 1 ライトペンの座標 ( pad =9,10) とスイッチ （pad = ll ) の情報は pad = 8 として BIOS 
をコールしたとき同時に読み込まれてバッファリングされますがのときの戻り値が 
0 FFFI の時だけ同時に読み込まれた他の値が有効となります. 
h 主意 2 1マウスとトラックボールは自動判別します. 

ni 意 3 |マウスやトラックボールの座標を求める場合まず入力要求を行い，その後に実際に座 
標を求めるコールをするという手順を踏みます.このとき2つのコールの時間間隔を 
できるだけ小さくして下さい.入力要求から座標の入力要求までの間が必要以上に開 
くと得られたデータは保証されません. 

TINY gtpdl ( pdl ) 

TINY pdl : 

指定されたバドルの内容を読みます. 

VOID chgsnd ( onoff ) 

BOOL onoff ； 

サウンドポートのビットのオン，オフを行うことにより音を発生します. data が0のとき才 
フ，0以外の時オンとなります. 
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TINY snsmat(row) 

TINY row : 

キーマトリクスの row で指定した行の値を読みます • 

戻り値の押されているキーに対応するビットが0になります. MSX のキーマトリクスについ 
ては 「 MSX 2 テクニカルハンドブック」をご覧下さい • 

VOID kilbufO 


キー ボードバッファの 内容をすべてクリアします. 

5.4.3 その他 


NAT rnd (range) 

NAT range ； 


0 から range — 1 までの範囲でランダムな整数を返します. 


VOID di () 

割り込みを禁止します. 

VOID ei() 

割り込みを許可します. 

BOOL msx2() 

MSX のバージョンを調べます.使用中のマシンが MSX 2 ならば真， MSX ならば偽が返されま 
す.本関数は， msxbios . h の中で定義されている# define マクロです. 


char * fnkstr ( fkey ) 

TINY fkey : 

指定されたフアンクシヨンキーの内容を保持しているエリアへのボインタを返します. fkey は 
1から10まででなければなりません.これは実際には msxbios . h で定義されているマクロです. 
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6.1 カーソル制御関数 ( MSX - CURSES ) の概要 

CURSES が UNIX のテキスト画面を扱うためのライブラリ関数群であることは既に述べまし 
た. MSX-CURSES は， UNIX の CURSES の中心的な関数についてはほぼサポートしており， 
根本的な原理も同じであるといって良いでしょう.ただし，個々の関数で若干仕様の異なるもの 
があり，その点注意が必要です. 

しかし， UNIX の CURSES を使った経験のある方でしたら， 6.4 の関数リフアレンスをご覧に 
なるだけで， UNIX の CURSES との違いを把握し，すぐにでもブログラムが可能でしょう.た 
だ，そうした方はごくまれだと思われますし， MSX-CLJRSES をより有効にお使いいただくため 
にはある程度の CURSES の原理に関する理解は必要でしょう.そこで，本節ではまずはじめに， 
MSX-CURSES の基本的な概念とその原理について解説した後， MSX-CURSES を構成する関 
数を総括的に見渡してみましょう. 

B .1.1 MSX - CURSES の画面更新最適化の原理 


A ) 用語の解説 

MSX-CURSES の原理について解説するに先立ち，解説中で統一的に用いられる概念を表す用 
語の解説を行います. 


物理画面 実際のテレビやモニタの画面のこと.実両面や，コンソール画面と呼ぶ場合もあ 

ります. 

ウインドウ 物理両面のある領域に現在どのような表示がなされているか，あるいは，どのよ 

うな表示がなされるべきかというイメージを常に保存する一種のバッファ. MSX 
-CURSES ではこのバッファ領域と画面上の位置などの情報を含め， WINDOW 
型の構造体としてウインドウを扱います. 


論理力ー ソル 各ウインドウはそれぞれの構造体にウインドウ バッファ 上の仮想的な カーソル 位 
置の情報も保存しています.ウインドウへの書き込みはこの論理カーソル位置に 
行われ，書き込み終了と同時に最後に書き込んだ位 H の1つ後ろに移動します. 

スクリーン 物理画面いっぱい（フルスクリーン）のウインドウを特にスクリーンと呼びます. 

論理画面 スクリーン，ウインドウを総して論理画面と呼びます. 
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B ) 最適化の原理 

MSX - CURSES の目的は，画面に文字を表示する際に，できるだけ効率よく画面の書換えを行 
なうということに尽きます.このことを画面更新の最適化と呼んでいます. 

MSX - CURSES では UNIX の CURSES と同様にスタンダードスクリーン （ stdscr ) とカレン 
トスクリーン ( curscr ) という二つのスクリーンを用いることにより画面更新の最適化を行います. 
二つのスクリーンはメモリ上にバッファ領域として，それぞれ(画面幅 X 行数)バイト（すなわち， 
物理画面の大きさと同じ）の大きさを持ちます.二つのスクリーンの用途はだいたい以下のとおり 
です. 

スタンダードスクリーン MSX - CURSES のスクリーンへの書き込みルーチン （ addch,addstr 

など）は物理画面にではなくこのスタンダードスクリーンに対し書き 
込みを行う.書き込みを行う座標は論理カーソル位置により決定する. 

カレントスクリーン 実際の画面のイメージを常に保存する.スタンダードスクリーンやそ 

の他のウインドウ，スクリーンに対して行われた更新を実画面に反映 
させる（これを画面のリフレッシュという）際にカレントスクリーンの 
内容(すなわち現在の画面表示の状態）と比較し変化のあった部分だけ 
を実画面に表示することになる.同時にカレントスクリーンの更新も 
おこなわれ次回の書き込みに備える. 


もう少し具体的に述べてみましょう. 

まず， MSX - CURSES の関数群を使用する前提として CURSES の初期化ルーチンを呼び出さ 
なくてはなりません.初期化ルーチン （ initscrO ) では，上記2つのスクリーンバッファのためのメ 
モリが確保され，両スクリーンは 20 H (スペースコード）で埋められます.論理カーソル位 E はホ 
—ムポジションに初期化されます. 


ここでスタンダードスクリーンへの書き込みルーチンにより，例えば 
addstr (，， Hello !!!”）; 

というようにすると，スタンダードスクリーンの最上行の先頭から” Hello ! ! 丨” という文字列 
が書き込まれ論理カーソル位置が最後の”！ ”の直後に移動します.この時点では実際の実画面に 
は何も表示されません.スタンダードスクリーンに行われた書き込みを実画面に反映す るには リ 
フレッシュを行わなければなりません.上の関数呼び出しに続いて， 

ref reshO ； 

とすることにより，はじめて実際の スクリーン 画面に Hello ! ! !と表示されます. 
refreshO では，スタンダードスクリーンとカレントスクリーンを 頭から1文字ず つ 比較して ぃ 
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き，一致しなかった文字だけをカレントスクリーンにコピーし，同時に実画面にも表示するので 
す.この例では，カレントスクリーンはすべてスペースで埋められていますから（両面がクリアさ 
れた直後の状態） Hello ! ! !という文字列だけが表示されます.さらに引続き， 

move (0, 0)； 

addstr (” Yellow !!”）; 

refreshO ； 

とするとどうでしょう.まず move によって論理力ーソルの位置をホームに戻してからスタンダ 
ードスクリーンへの書き込みを行なっています.これによりスタンダードスクリーンには’’ 
Yellow! !”の文字列が” Hello! ! !”に上書きされました. 

ここで refreshO の行う動作を追ってみます. 

まず，” Y” と” H” が比較され，一致しないため実画面の左上はしに’’ Y” が表示されカレン 
トスクリーンにも” H” にかわって’’ Y” のキャラクターコードが書かれます • スタンダードスク 
リーンもカレントスクリーンも次の文字は” e” ですからなにもしません.’’ 〇” までは一致し続け 
ますから同様です.” w” でようやく 2 文字 R の表示が行われます.それ以降は画面の最後まで(最 
後の”！”以降はどちらもスペースで埋まっているから一致する）実際の画面更新は起こらずリフ 
レッシュを終了します.以上で画面更新最適化のアルゴリズムの基本的な部分が理解いただけた 
と思います. 

MSX-CURSES ではこのほかにも画面の書換えをより効率よく行うために多くの内部的なエ 
夫がなされています.例えば， refreshO は呼ばれる毎に全ての文字上匕較をおこなうのではなく変 
更のあった行の変更された範囲に限って比較をおこなうといった具合いです. 

およそ CURSES などどいった UNIX 流のライブラリに，はじめて接する方にとっては以上の 
説明は甚だ不足しているかと思われます. MSX-CURSES の実用性についても疑いをもたれる方 
も多いでしょう.しかし， MSX-CURSES の関数群を，その特性を理解し活用することによって 
UNIX の vi のようなエディタを最小限の労力で作成することも十分に可能であると考えます•さ 
らに MSX-CURSES の画面更新の実効性についても，付属のサンプルプログラムを実際に動か 
すことで実感していただけると思います. 

6 . 1. 2 ゥィンドゥ _ 

CURSES では，画面上の任-意の位置に任意の大きさのウインドウを開き各ウインドウについて 
その内容の更新を行うことができます. addchO には waddchO, moveO には wnioveO のように 
スタンダー ドス クリーン への書き込み関数の名前に” w ” をつけたものが 同一 機能のウインドウを 
扱う関数です. 

スタンダードスクリーンやカレントスクリーンもフルスクリーン（画面いっぱい）のウインドウ 
と理解することができ，データ構造もユーザが newwinO 関数により開いたウインドウとまった 
く同じです.したがってスタンダードスクリーンを扱う関数の大半はウインドウを扱う関数を， 
stdscr (スタンダードスクリーン）というウインドウを引き数として呼び出しているに過ぎません. 
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たとえば addch ( ch ) は waddch ( stdscr , ch ) という呼び出しをおこないます. 

さらに，リフレッシュについても wrefresh () という関数があり，ウインドウ毎に行うことがで 
きるのです. 

6.1.3 MSX - CURSES 関数パッケージの概要 _ 

ここでは， MSX - CURSES の関数群を機能の面から下のようなグループにわけ，簡単に紹介し 
ていきます. 

•初期化，オプションモードの設定 
• 論理画面への®き込み 
• コンソール画面の更新 
• 論理画面からの入力 
• コンソールからの入力 


A ) 初期化，オプションモードの設定 

MSX - CURSES の関数を用いるためには前述したようなバッファ等の初期化を行わなければ 
なりません.さらに画面更新時に画面をはみ出したときの処理をどうするか，などのモード指定 
が可能です. 


B ) 論理画への書き込み関数 

MSX - CURSES においては，前述のように，ウインドウやスタンダードスクリーンへの書き込 
みとリフレツシュの繰り返しにより画面への文字の出力が行われます.ウィンドウやスタンダー 
ドスクリーンへの書き込みルーチンには，単に文字や文字列を書き込むだけでなく，行や文字の 
削除および挿入，行のスクロール，標準関数の printfO に匹敵するような書式付きの書き込みを行 
うルーチンなどもあります. 


C ) コンソール画面への出力を行5関数 

コンソール画面への文字出力を行う関数は，前述の re f res h () と wrefreshO です.この関数はス 
タンダードスクリーンやウインドウについて設定されたオプションモードに従って，つねに最も 
効率のよい画面更新を行います.リフレッシュでは両面を更新すると同時に，カレントスクリー 
ンの更新も行います. 


D ) 論理画面からの入力関数 

MSX - CURSES にはウインドウやスクリーンから情報を得るための関数も用意されています 
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すなわち，現在の論理 カーソルの 位置や， カーソル 位置にある文字を知ることができます.これ 
らの関数を用いれば，例えば画面に メニューの一 覧が表示され，実行したい機能を メニュー 表示 
に カーソルキーを 合わせてリターン キーを おすことにより任意に選べるなどの， ビジュアルなコ 
マンドを作成することもできるでしょう. 


E ) コンソールからの入カルーチン関数 

コンソールからの入力では，キーボードから入力された文字を画面にエコーバックするかどう 
かを設定することができます. 

コンソール 入力関数と しては，コンソールのキーボー ドから コンソールモードに従って 文字 や， 
文字列の入力を行う関数があります. 


B.S MSX-CURSES 関数パッケージの使用法 

MSX-CURSES の各関数を用いる際には，ソースプログラム内で curses .h をインクルードす 
る必要があります. 

ライブラリファイルは mlib.rel で，これをリンク時にユーザプログラムより前におきます. 
FPC によるパラメータチェックの際には mlib.tco をチェックの対照としなくてはなりません. 
以上，コンパイルからリンクまでの手順は msxc.bat というバッチファイルで提供されています. 


6-3 MSX-CURSES 関数一覧 


初期化処理，オプションモードの設定など 


関数名 

用途 参照ぺ 

ージ 

mitscr 

MSX-CURSES を用いるための初期化を行う関数 

78 

new win 

新たにウインドウを開く 

78 

sub win 

ウインドウ内に新しいウインドウを開く 

78 

end win 

CURSES を用いたブログラムを終了するときに呼ぶ関数 

79 

mvwin 

ウインドウのホームポジシヨンの座標変更 

79 

delwin 

ウインドウを閉じる 

79 

scrollok 

カーソルがスクリーンからはみ出した場合の処理決定 

79 
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コンソール出力関数 


関数名 

用途 

参照ページ 

refresn 

実画面の更新を行う 

80 

wrefresh 

)) 

80 


論理画面への害き込み関数 


関数名 

用途 参照べ • 

ージ 

move 

論理カーソル位置の移動 

80 

wmove 

/； 

80 

addch 

現在の論理カーソル位置に1文字書き込む 

80 

waddch 

}} 

80 

mvaddch 

論理カーソルを任意の位置に移動後1文字書き込む 

81 

mvwaddch 

}) 

81 

addstr 

現在の論理カーソルの位置に文字列を書き込む 

81 

waddstr 

；； 

81 

mvaddstr 

論理カーソルを移動後文字列を書き込む 

81 

mvwaddstr 

n 

82 

box 

ウインドウを指定したキャラクタで囲む 

82 

overwrite 

ウインドウから別のウインドウにバッファの内容をコピーする 

82 

touchwin 

画面更新の最適化のための情報を無効にし次回のリフレッシュ時にゥ 


インドウの全面に比較を行う 

82 

erase 

論理画面をスペースでうめる 

83 

werase 


83 

clear 

ウインドウをクリアする 

83 

wclear 

n 

83 

clearok 

クリアフラグのオン，オフを行う 

83 

clrtobot 

論理カーソル位 R から画面の右端までをクリアする 

84 

wclrtobot 

)) 

84 

clrtoeol 

論理カーソル位置からその行末までをクリアする 

84 

wclrtoeol 

;; 

84 

delch 

論理カーソル位置の1文字を削除する 

84 

wdelch 

)) 

84 

mvdelch 

論理カーソルを移動後】文字を削除する 

84 

mvwdelch 

n 

84 

deleteln 

論理カーソル位置の1行を削除する 

84 

wdeleteln 

)) 

85 

insert In 

論理カーソル位置に空行1行を挿入する 

85 

winsertln 

)) 

85 
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関数名 

用途 

参照ページ 

scroll 

ウインドウ内で 1 行 スクロールを 行う 

85 

insch 

カーソル位置に 1 文字揷入 

85 

wmsch 

n 

85 

mvinsch 

論理カーソルを移動後その位置に 1 文字挿入 

85 

mvwinsch 

n 

85 

printw 

ウインドウへの書式付き®き込み 

86 

wprintw 


86 

mvprintw 

論理カーソルを移動後の書式付き書き込み 

86 

mvwprintw 

n 

86 


論理画面からの入力関数 


関数名 

用途 

参照ページ 

inch 

論理カーソル位置の文字を返す 

86 

winch 

n 

86 

mvinch 

論理カーツルを移動後カーソル位置の 1 文字を返す 

86 

mv winch 

n 

86 

getyx 

現在の論理カーソル位置を返す 

87 


コンソールからの入力関数 


関数名 

用途 参照ページ 

echo 

コンソールキーボードから入力を行う際に入力された文字を画面に表 
示するかどうかの決定をする 87 

noecho 

” 87 

getch 

コンソールキーボードからウインドウの論理カーソル位置に 1 文字読 
み込む 87 

wgetch 

〃 87 

mvgetch 

論理カーソル移動後 getch 0 ， wgetch 〇によりコンソールから1文字 
を読み込む 87 

mvwgetch 

〃 87 

getstr 

コンソールキーボードからウインドウのカーソル位置に 1 行読み込む 87 

wgetstr 

か 88 

mvgetstr 

論理カーソルの移動後コンソールからウインドウに 1 行読み込む 88 

mvwgetstr 



厂注意 I 関数名で，先頭に’ W ’ がつかないものと， V のつくものがある場合，前者がスタンダー 
ドスクリーンを扱う関数で，後者が同一機能で，スタンダードスクリーン以外のスク 
リーンやウインドウを扱うものです. 
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李— y ; 

—f irs1,c:h; 
_ lastch ； 
i ns ck! I: 


} INDEXUN ； 


iypedef struct { 


TINY 

ry, — curx 

TINY 

wvdxx , jnaxy 

i nt 

, be^y 

i nt 

f la^s ； 

BOOL 

„ c: l ea r ； 

BOOL 

„1eave ； 

BOOL 

scroll; 

INDEXUN 

李， index ； 

} W_0W; 



O 論理カーソル位置 
C ： ウインドウの大きさ 
〇ホームポジションの座標 
〇最適化に用いるフラグ 
〇クリアフラグ 
〇未使用 

〇スクロール フラグ 
〇各行毎の情報 


〇行 バッファ 

〇変更のあった最初のカラム 
〇最後のカラム 
¢3ハー ドウ ェ アスク ロールの 
ためのフラグ 


6.4 MSX-CURSES 関数リファレンス 


6,4.1 MSX - CURSES のシステム変数，データ構造 _ 

MSX - CURSES では以下のような変数名が予約されています.ユーザはこれらの名前をユーザ 
プログラム内で再定義することはできません.またこれらの変数の内容を変更する場合でも 
MSX - CURSES の関数を介してのみ行うことができます. 


A ) システム変数 


TINY 

LINES ; 

コンソール画面の行数. initscrO により初期化される. 

TINY 

COLS ; 

コンソール画面のカラム数 . initscr 0により初 J 期化される 

TINY 

_ tty ; 

コンソール入力時の入カモードのフラグ. 

WINDOW 

* stdscr ; 

スタンダードスクリーンへのポインタ 

WINDOW 

* curscr ; 

カレントスクリーンへのポインタ 


B ) ウィンドウの構造 

ウインドウのデータのための構造体” WINDOW ” は curses . h のなかで次のように型定義され 
ています.通常はこれらの構造体の内容を直接変更，参照する必要はありません. 



i h n n 
sc i j 
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6.4.2 初期化処理，ねシヨンモードの離など 


WINDOW *initscr() 

MSX - CURSES の各ルーチンを用いる場合には必ず呼ばなければならない初期化のための関 
数です. 

stclscr (スタンダードスクリーン）と curscr (カレントスクリーン）の2つのウインドウ領域を確 
保し，これを初期化します.戻り値は stdscr へのポインタが返されますが，領域の確保に失敗し 
たときは NULL を返します. 

WINDOW *newwin(lines,cols f begin v,begin x) 
int lines,cols,begin_y,gengin_x ； 

新たにウインドウを開設します， lines ， cols でウインドウの行数，カラム数を， begin _ jy ， begin_x 
でウインドウのホームポジションの位置を指定します， 

戻り値は WINDOW 型の構造体へのポインタが返され，以後，これを用いてウインドウヘアク 
セスします.また，ウインドウのためのバッファ領域が確保できなかった場合 NULL が返されま 
す. 

もし， lines ， cols に0を指定した場合 

lines = LINES (物理画面の行数）- begin — y ; 
cols = COLS (物理画面のカラム数）- be ^ m . x ； 

となります.したがってフルスクリーンのウインドウ（すなわちスクリーン）を開きたい場合は 

WINDOW ^ fullwin ； 

fullwin = newwin(0, 0, 0, 0 )； 

として下さい. 

WINDOW *subwin(win,lines,cols,begin_y,begin 一 x) 

WINDOW *win ; 

int lines,cols,begin—y,beginjc; 

ウインドウの中に，新しいウインドウを開きます. newwin と異なる点は，どちらかのウインド 
ウに対して行われた書き込みが他方にも反映されることです. 
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win で指定したウインドウとバッファエリアを共有するウインドウが開かれるわけです. 

サブウインドウの位置と大きさは， win で指定する外側のウインドウの中に入るように指定し 
なくてはなりません.サブウインドウのためのメモリが足りなかったり，サブウインドウの位置 
や大きさが不適当な場合 NULL が返されます. 

VOID endwinO 


CURSES を用いたプログラムを終了するときに呼ぶルーチンです.スクリーンデータのための 
バッファ領域を解放します， 


STATUS mvwin ( win , y , x ) 

WINDOW 氺 win ; 
int y,x ; 

ゥインドウのホームポジションの座標を （ x ， y ) に移動します.もし （ x 、 y ) がコンソール画面の端 
をはみ出してしまう場合，本関数は ERROR を返し，移動は行われません. 

VOID delwin ( win ) 

WINDOW *win ; 

win で指定したウインドウを閉じます.ウインドウのためのバッファは解放されます . delwinO 
でバッファを解放しても，画面表示に影響を与えません. 

このルーチンでサブウインドウ ( subwin で開設したウインドウ）を閉じても，ウインドウのバッ 
ファ領域の解放は行われません.通常，外側のゥインドゥを解放した後，サブゥインドゥを閉じ 
ることにより，バッファ領域の解放を行います. 

VOID scrollok ( win , boolf ) 

WINDOW *win ; 

BOOL boolf ； 

論理カーソルが，ウインドウやスクリーンの最下行からの改行や，最終行の最終桁での文字入 
力によりスクリーンからはみ出した場合の処理を決定します • 本ルーチンで boolf に TRUE をし 
てすると，上記の場合，強制的にゥインドゥ内で1行スクロールが起こります， 

逆に， boolf を FALSE で実行するとウイ ン ドウの スクロールが 禁止され，ウイ ン ドウの右下隅 
に文字は出力されなくなります. 



B .4,3 コンソール出カルーン _ 

STATUS refresh () 

STATUS wrefresh(win) 

WINDOW *win ; 

実画面への衷示を行います.スクリーンやウインドウへの書き込みをおこなった後に，リフレ 
ッシュすることによりはじめて実両面への表示が行われます.同時に，カレントスクリーンの更 
新も行います. y 

refresh 0はスタンダードスクリーン ， wrefresh 0はその他のスクリーンやウインドウの更新に 
用います. 

6-4.4 論理画面へ の書き込みルーチン _ 

STATUS move(y # x) 
int y,x ; 

ST ATUS wmove (win, y, x) 

WINDOW *win : 

int y,x ; 

論理カーソル位置を移動します. 

move 0では，スタンダードスクリーン ’’ stdscr ” 上の論理カーソルを （ x ， y ) で指定した位置に移 一 

動します • y ， x が画面の範囲外の時は ERROR が返されます. 

その他のスクリーンやウインドウの論理カーソルは wmoveO で移動します. 

スクリーンやウインドウへの書き込みは常に論理カーソル位費に対して行われます. 

STATUS addch(ch) 
char ch ； 

STATUS waddch (win, ch) 

WINDOW *win : 

char ch ； 

スクリーンやウインドウの現在の論理カーソル位 IS に1文字を書き込みます • ff き込むキヤラ 
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クタを ch で与えます. 

addchO はスタンダードスクリーンに対しての S •き込み， wadclchO はそれ以外のスクリーンや 
ウインドウに対しての書き込みを行しゝます. waddchO で®き込みを行うウインドウは win で指 
定します. 

文字を書き込むことにより，ウインドウをはみ出す場合，スクロールが禁止されていると 
ERROR となります.それ以外の場合は自動的に スクロールが 起こります. 

(但し，強制的にリフレッシュが起こることはありません.） 

STATUS mvaddch (y , x , ch) 
int y,x ； 

char ch ； 

STATUS mvwaddch (win,y,x,ch) 

WINDOW *win : 
int y t x : 

char ch ； 

論理カーソルを任意の位置に移動後， 1 文字を書き込みます. 

論理 カーソルの 移動先を （ x ， y )， 書き込むキャラクタを ch で与えます.論理 カーソルの 移動先 
が 不適当であったり， スクロールが 禁止され ている ウインドウで， スクロールが 起こる ような 書 
き込みが行われた場合 ERROR となります . 

STATUS addstr(str) 
char 氺 str ; 

STATUS waddstr(win,str) 

WINDOW >Nvin : 
char 氺 str ; 

現在の論理カーソルのある位置に文字列を書き込みます. 

書き込む文字歹! I へのポインタを引き数として渡します. addstrO や waddstr 0は waddchO を 
文字数分だけ呼んでいるので ERROR となる条件は waddchO と同じです. 

STATUS mvaddstr (y , x , str) 
int y,x ; 

char 氺 str ; 


STATUS mvwaddstr (win, y, x, str) 
WINDOW 氺 win ; 
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int y,x; 

char *str ； 

論理カーソルを移動後，文字列の書き込みをおこないます 

( x ， y ) で論理力ーソルの移動先， str は書き込む文字列へのポインタを渡します， ERROR の返 
される条件は wmove ， waddstr の場合と同じです. 

ST ATUS box (win, vert , hor) 

WINDOW *win ； 
char vert,hor ； 

ウインドウ内を指定したキャラクタで箱状に囲みます. 

vert で垂直枠のキャラクタ， hor で水平枠のキャラクタを与えます. 

本命令はウインドウ.に枠をつけたい場合に用いられます • 通常 ， box 〇により枠取りをしたウイ 
ンドウの内部に枠が壊されないような大きさのサブウインドウを開き，書き込みはサブウインド 
ウに対して行うなどにより用います. 


r 呼び出し例 I 

win = newwin(0 ， 0 ， 0 ， 0); 

sub = subwin(win ， （ int)LINES • 2, (int)COLS - 2,1,1 )； 
box(win, ， l’, ，-，〉； 

wrtwin(sub )； /* 書き込みを行う関数*/ 

VOID overwrite (win 1,win2 〉 

WINDOW *winl,*win2; 

ウイ ン ドウから別のウインドウに対して， バッファの 内容のコビーを行います. 

\ vinl から win 2 にウインドウの重なった部分のみがコピ'一されます. 2つのウインドウに重な 
った部分のまったくない場合にはコピーは行われません • 

STATUS touchwin(win) 

WINDOW 氺 win ; 

画面更新の最適化のための情報を無効にし，次回のリフレシュ時，にウインドウ全面の比較を行 
うようにします. 

CURSES では一部または全部が®なったウインドウを交互に更新した場合，画面更新の最適化 
処理が逆に災いして正常に更新されません. touchwinO により最適化処理の一部を無効にするこ 
とにょり重なりあったウインドウを交互に更新する際にも，正常な更新を行うことができます. 
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具体的には，更新（リフレッシュ）したいウインドウが直前に更新したウインドウと異なり，か 
つ2つのウインドウに重なった領域がある場合に今回更新すべきウインドウに対して用います. 


r 呼び出し例1 

STATUS func ( win ) /* 重なりあったウインドウを更新する関数 */ 
WINDOW Iwin ； 

{ 

static WINDOW ^lastwin = NULL ; 

i fOasiwin != win ) { 
lastwi n = win ; 
touchwin ( win )； 

} 

return ( wrefresh ( win ))； 

} 


VOID erase () 

VOID werase ( win ) 

WINDOW 本 win ; 

論理画面をスペースで埋めます. eraseO でスクリーンをクリアしても，クリアフラグはセット 

されません. 

STATUS clearO 

STATUS wclear ( win ) 

WINDOW *win ; 

eraseO を呼び出した後，次の dearokO を呼び出しクリアフラグをオンにします. 
wclearO でカレントスクリーンをクリアすると，スタンダードスクリーンがスペースクリアさ 
れ，強制的にリフレッシュがおこり画面がクリアされます.本関数は ERROR を返しません.（常 
に OK 力《返される） 

VOID clearok ( scr , boolf ) 

WINDOW *scr ; 

BOOL boolf ； 

クリアフラグのオン，オフを行います. 

クリアフラグがオンのスクリーンにたいしてリフレツシュを行うと，物理画面をクリアした後， 
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リフレッシュをおこないます.この際，クリアフラグは自動的にリセット（オフ）されます. 
クリアフラグのオン，オフはスクリーンに対してのみ有効です. 


VOID clrtobotO 

VOID wclrtobot ( win ) 

WINDOW *win : 

論理カーソルの位置から論理画面の右端までをスベースでクリアします. 

VOID clrtoeolO 

VOID wclrtoeol ( win ) 

WINDOW *win : 

論理カーソルの位置からその行末までをスペースでクリアします. 

STATUS delchO 

STATUS wdelch ( win ) 

WINDOW *win ; 

論理カーソル位置の 1 文字を削除します. 

カーソル位置より右にある文字はすべて1文字ずつ左に詰められます.本関数は ERROR を返し 
ません.（常に 0 K が返される） 

ST ATUS mvdelch ( y , x ) 
int y,x ; 

STATUS mvwdelch ( win , y , x ) 

WINDOW *win : 
int y,x ; 

論理力ーソルを移動後 1 文字を削除します. ERROR の返される条件は， wnioveO と同じで 


す. 


VOID 

deleteln () 

VOID 

wdeleteln ( win ) 
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WINDOW *win : 

論理カーソル位置の1行を削除します. 

以降の行が1行ずつ上に詰められ最下行は空行となります. 

VOID insertlnO 

VOID winsertln(win) 

WINDOW *win ; 

論理カーソル位置に空行 1 行を挿入します. 

STATUS scroll (win) 

WINDOW 氺 win ; 

ウインドウ内で lfi 1 スクロールをおこないます.ウインドウの最下行は空行.になります. 

STATUS insch(ch) 
char ch ; 

ST ATUS winsch (win, ch) 

WINDOW *win ; 
char ch ; 

論理カーソル位置に 1 文字を挿入します. 

この際画面からはみ出した文字のデータは失われてしまいます.本関数は ERROR を返しませ 
ん.（常に OK が返される） 

STATUS mvinsch (y,x # ch) 
int y,x ; 

char ch ； 

STATUS mvwinsch (win f y ,x,ch) 

WINDOW *win ; 
int y,x ; 

char ch ； 

論理カーソルを移動した後その位置に1文字を挿入します. ERROR が返される条件は， 
wnioveO と同じです. 
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STATUS printw (format , argl / arg 2_) 

char ^format : 


STATUS wprintw ( win , format , arg 1, arg 2_) 

WINDOW *win : 
char ^format ； 

ST ATUS mvprintw ( y , x , format , argl , arg 2_) 

int y,x ; 

char *format ; 

ST ATUS mvwprintw ( win , y format , argl , arg 2_) 

WINDOW *win ; 
int y,x ; 

char *format ； 


6.4.5 論理画面か 6© 入力 


char inch () 


char winch vwin ) 


WINDOW *win ; 


論理カーソル位置の文字を返します. 

関数の戻り値として論理カーソル位置の1文字が返されます. 

char mvinch ( y , x ) 
int y,x ; 

char mvwinch ( win,y f x ) 

WINDOW *win ; 

int y,x ; 

論理カーソル移動後の論理カーソル位置の1文字を返します. 
カーソルの移動位置が不適当な場合 ERROR が返されます. 
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VOID getyx(win,y,x) 

WINDOW *win : 
int y,x; 

指定されたウインドウの現在の論理カーソル位置を y ， x に代入します, 
このルーチンは curses . h の中でマクロとして定義されています. 

B .4. B コンソールからの入力をおこな5関数 


VOID 

echo() 

VOID 

noechoO 


getchO や getstrO などによりコンソールのキーボードからの入力を行う際に入力された文字 
を画面に エコーバックす るかどうかを決定します. echoO で エコー オン， noechoO で エコー オフ 
です.初期^!犬態はエコーオンです. 


char getch 〇 

char wgetch (win) 

WINDOW *win : 


コンソールキーボードからウインドウの論理カーソル位置に 1 文字読み込みます. getchO では 
スタンダードスクリーンに， wgetch () では指定したウインドウに，それぞれコンソールからコン 
ソール モードに 従って， 1文字を読み込みます. 

’¥ r ’（ キヤリツジリターン），は， ¥ n ’（ ニューライン）にマッピングされます 


char 

mvgetch (y,x) 

int 

y,x ; 

char 

mvwgetch(win,y,x) 

WINDOW 

*wjn ； 

int 

y,x ; 


論理力ーソルを移動後， getchO , wgetch () によりコンソールから1文字を読み込みます. 
力ーソルの移動先が不適切な場合（ウインドウをはみ出す場合) ERROR が返されます 


8フ 


STATUS getstr(str) 
char 氺 str ; 

STATUS wgetstr (win, str) 

WINDOW *win ; 
char 本 str; 

コンソールキーボードからウインドウの論理力ーソル位 a に， 1 行を読み込みます. ，¥ n ’ が入力 
されるまで読み込まれ， str でポイントされる文字配列に格納されますが，この際’ ¥ n ’ は除かれ代 
わりに NUL (’¥( T ) がつめられます.本関数は ERROR を返しません.（常に OK が返される） 

STATUS mvgetstrCy.x^tr) : 
int y,x; 

char *str ； 

STATUS mv wgetstr (wi n, y, x, str) 

WINDOW *win ; 
int y,x ; 

char *str ; 

論理カーソルの移動後，コンソールからウインドウに対して，1行を読み込みます • 

カーソルの移動先が不適切な場合（ウインドウをはみ出す場合) ERROR が返されます. 
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付録サンブルブログラム集 


A ) 数値演算パッケージを用いた:?□グラム” den ” について 


1 概要 _ 

den は MSX - C ライブラリパッケージに含まれる数値演算モジュールを使用した整数型16進 
電卓プログラムです（]〇進計算も可).通常の電卓のようにメモリへの代入，参照やカッコ計算を 
含む優先順位を考慮した計算ができます. 


g den の使用例 _ 

ここでは簡単な使用例を示します.電卓としての詳細は次頁の「3仕様」を参照して下さい. 
den の起動は MSX - DOS プロンプトが出ている時 ， den 0 と入力するだけです.すると， 
数値モードの文字 ( D ， U , X ，0 のどれか）が左端に表示され，その右に初期値0が表示されます. 

D 0 

数値を入力すると0が入力にあわせて変化していきます.1350と入力すると表示は， 

D 1350 

となります.以下入力とそれに対する表示を示します. 


入力 

表示 


+ 

D 

1350 

23 

D 

23 

= 

1) 

1373 

*5= 

D 

6865 

MO 

D 

6865 

/23= 

D 

298 

+ m 0 

0 

6865 

= 

n 

7163 

%1= 

D 

2 

2*( 

D 

0 

3+5 

D 

5 


D 8 

D 16 
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このようにほとんど普通の電卓のように動作します.ただし，キーの割り付けが C 言語風なので 
注意して下さい. 


3 仕 _ _^_ 

ここでは， den の仕様と，キーの割り付けを説明します.キーの割り付けに使われる文字は大文 
字と小文字の区別がされます. 


3.1 数値モード(基数） 

den の数値モードは，符号つき10進と符号無し10進，16進，8進の4種類があります.符号つ 
きと符号なしの違いは商，剰余を求める場合と，算術右シフトを行う場合にのみ現れます.その 
他の場合に違いは出てきません.基数の違いは入力と出力に指定された基数を使って行われるだ 
けにすぎません.数値モードの変更は次のようになります. 

符号つき10進 ： D 
符号無し10進 : U 
符号無し16進 ：X 
符号無し8進： 0 

数値モードは常に数値表示欄の左端に D , U ， X . 0の文字で表示されています. 


3_2罱数 

置数(数字を入力すること）は数値の上位の桁から1桁ずつ入力します.符号つきで負数を入力 
する場合は，〇以外の数値を入力してから符号を反転させる文字」アンダースコア）で負数にしま 
す，入力を間違えた場合は BS ( BACKSPACE ) キーを使用することによって1桁ずつ取り消すこ 
とができます.また，入力された数値が使用できる数値の範囲を超えた場合には，上位の桁がな 
くなります.置数時有効な文字は基数によって変わってきます.使用できる文字を数値モード別 


に示します. 

符号つき10進 
符号無し10進 
符号無し16進 
符号無し8進 


0 1 2 3 4 5 6 
0 1 2 3 4 5 6 
0 1 2 3 4 5 6 
0 1 2 3 4 5 6 


7 8 9 _ 

7 8 9 

789 abcdef 

7 




3.3 使用できる数値の範囲 

den で扱われる数値はすべて SLONG 型 (32 bit ) となっています.それぞれの数値モードの表現 
で使用できる範囲を示します. 
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符号つき10進： 一2147483648 から2147483647 
符号無し1〇進： 〇から4294967295 
符号無し16進： 〇から FFFFFFFF 
符号無し8進： 0から37777777777 


3.4 オールクリア，クリア,= 

オールクリアは，計算を始める前に行うことで，それまでの計算に影響を受けることなく実行 
することができます（表示レジスタ，数値スタック，演算子スタックをクリアします）.またクリ 
アは，置数に大幅な間違いが見つかったときに使用することで，キー入力数を少なくすることが 
できます(表示レジスタのみをクリアします）.=はそれまでの入力をすべて計算して，結果を表示 
するのに使います. 

A オール クリア 

C クリァ 

リターンキー =と同じ 


3.5 二項演算子およびカツコ 

二項演算子には加減乗除•剰余(+ — */%)，論理積•論理和•排他的論理和 (& ! がありま 
す.おのおのの演算子には優先順位がついており，優先順位の高い演算から実行されます.この 
優先順位を変更するためには，優先順位を上げたいところでカツコを使用します.優先順位の順 
位表を示します.順位は小さい方が優先度が高く，優先順位が同じものについては式を入れた順 
に評価されます. 

1 () ( カツコ） 

2 * / % (乗算，除算，剰余） 

3 +— （加算，減算） 

4 & (論理積） 

5 ! (論理和） 

6 a (排他的論理和〉 


3.6単項演算子 

演算子には二項演算子の他に単項演算子があります.これは演算子のキーを押すと，表示され 
ている数値に演算をし，演算結果を表示するものです.ですから優先順位はありません(言いかえ 
ると®高位の優先度).単項演算子には否定 ( not )， シフト•ローテイトがあります. 

〜 （否定ビットごとの反転） 

く （左シフト） 

> (右シフト符号ありの場合は算術右シフト） 
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[ (左 ローテ イト） 

J (右ローテイト） 

{ (キャリーを含んでの左ローテイト） 

} (キャリーを含んでの右ローテイト） 

シフトとローテイトに関しては1回のキー操作で1ビットずつ移動します.また，匱数時に使 
われる符号反転し）もこの単項演算子のひとつと考えられます. 


3.7 メモリ機能 

メモリ機能は4種類あり，代入•参照•加算•減算となってます.それぞれ電卓的表現で， Min . 
MR-M + - M —となります.メモリは番号0から9までの10個があります.メモリを使用する場 
合にはメモリ機能の操作(下記参照）に1桁のメモリ番号 (0-9) を指定します.メモリ機能は次のよ 
うになります. （# はメモリ番号） 


M # 

メモリへの代入 （ Min 〉 

m # 

メモリの参照 （ MR ) 

MH -# 

メモリへの加！？ (M + ) 

M -# 

メモリからの減算 ( M —） 


M + . M — に，イコール機能はありません.また，数値モードが変更された場合には現在のモー 
ドで表示されます(符号ありと符号なしが混在している場合には注意が必要です). 

4 コンパィル方法 _ 

den . com のソースフアイルは den . c です. 

コンバイルは C ライブラリに含まれる msxc . bat にコンバイルスイツチをつけてコンパイル 
します. 

A>msxc den - r 5:6:2 - r 2000 0 


5 注意点 


5.10 による麟•剰余 

サンプルとして含まれている den は0による除•剰余のエラーチェックをまったく行ってい 
ません.ですから，カツコの多い複雑な式を計算する場合には除数にご注意下さい. 
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付録サンプルブログラム集 


5. S カツコの機能について 

den はカツコつきの計算ができますが，そのもとの機能は少し特殊です.左カツコ，(’が入力さ 
れるとそれ以降の演 e の優先度を上げ，右カツコ〇 ’ が入力されるとそれに対応する左カツコから 
右カツコまでの計算を行います.ですから，演算子を忘れて左カツコを入力しても den はそれを 
カツコとして受け付けます • 実際の例を示すと， 2 X 3(+2)= と入力すると den では 2 X (3+ 
2)=と入力されたものと認識します. 
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B ) グラフイツク關数を用いたブ□グラム w gear について 


1 概要 _ 

サンプルブログラム ” gcal ” は，グラフィック関数を使って2力月分のカレンダーとバイオ 
リズムをグラフィック画面に描くというプログラムです.マシンが MSX の場合は自動的に 
MSX 用（スクリーンモード2>が， MSX 2 の場合は（スクリーンモード 5) が動作します. 


g 使用方法 _ 

MSX-DOS のコマンドラインより次のような入力を行って下さい. 
goal [/ h ] < yyyy / nirn / dd > < yyyy / mm / dd > 

最初の日付は生年月日を，2番目の日付は調べたい H を入力して下さい. 2番目の日付は，調べ 
たい日が’’今日’’であるときに限り省略が可能です • このときは， MSX 内の CLOCK-IC から呼 
び出してきますので， CLOCK-IC の日付が，正しいかどうか確認されることをおすすめします. 
なお，日付の変更方法は， MSX-DOS TOOLS の MSX-DOS manual 第 2 部をご覧下さ 
い.日付の区切りは， ’ /’のほかに，-，，，，（空白）が使用できます • カレンダーは，2番目の日 
付の月と，その次の月，バイオリズムは，調べたい日を中心に 41 日分を表示します .’’gcal” のあ 
とに，’’/ h ” オプションをつけることによりコマンドリファレンスを表示，参照することができま 
す. 

3コンパ ィル方法 __ 

gcal.com のソースファイルは gcal.c です. 

コンパイルは C ライブラリに含まれる msxc.bat にコンパイルスイツチをつけてコンパイル 
します. 


A>msxc seal -「13:11:4 -「1500 @ 


4 注意点 ___ 

動作が終了すると停止状態になりますが，， q ’，’ Q ， 又は ESC キーを 押すことによって MSX - 
DOS に戻ります.但し，コントロール- STOP をしてしまった場合は，グラフイツク画面のまま 
終了してしまいますのでリセツトをかけて下さい • 
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C)MSX_CURSES を用いた :? tl グラム ” show ” について 



MSX-DOS の コマンド ラインで 1 つまたは 2 つのフアイル名を与えて起動することのより 1 
つめのフアイルの1 ページ 目が表示されます•その後の コマンド として以下のものが有効です 


ESC ファイルを2つ指定した場合もう一方のファイルに表示を切り替えます • ファイルを 

1つしか指定しない場合は無効です.. 

RET 1 行スクロールします . 

DOWN 5行スクロールします. 

SPACE 次のページを表示します. 

q/Q コマンドを終了します. 

h /? ヘルプを表示します. 

SHOW はフ ァイル表示のための2つのウインドウと先頭行の ステータス ライン及び ヘルプ 表 
示のためのウインドウの計4つのウインドウをもちいています. MSX - CURSES のプログラミン 
グ例としてソースファイルをご参照ください. 
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お問い合わせについて 


弊社では厳重に梱包した上，細心の注意を払って製品を発送しております.万一，輸送上の卜 
ラブルが起こった場合にはご一報いただければ新しいものと交換いたします. 

マニュアル作成にあたり，なるべく詳細な説明をするように心がけたつもりですが，理解でき 
ないところは，実際にコンピュータと向きあって納得のいくまで確かめて下さい.また，他のぺ 
ージを参照するのもひとつの方法です.それでも疑問点が解決できないときは，購入された販売 
店に問い合わせるか, ㈱ アスキーューザーサポート（直通電話 03-3498-0299) までお電話いただけ 
れば，係がお答えします.しかしながら，回線が混み合いご迷惑をかけることもありますので， 
なるべくお手紙にてお願いいたします.その際には，下記の要領で言己入して下さい.記入されて 
ない項目が一つでもありますと，回答できかねる場合があります.十分注意して下さい. 

また，本製品以外に対してのご意見，ご希望がございましたら，弊社までおよせください. 

-記- 

1. 送付先亍 107-24 東京都港区南青山 6-11-1 スリーエフ南青山ビル 

株式会社アスキー ューザー サポート係 
TEL . 03-3498-0299 

(祝祭日を除く月〜金曜日，10: 00〜12: 00,13 : 00-17 : 00) 

2. 必要項目 

⑴お客様の氏名，住所(郵便番号)，電話番号(市外局番も含む） 

(2) 製品名，製品シリアル番号 
⑶機器構成 

本体装置名，メモリバイト数 
CRT 装置名，フロッピーディスク装置名 
プリンタ装置名 
その他 I / O , I / F 装置名 
(4) お問い合わせ内容 

お問い合わせの内容は，できるだけ製品のマニュアルに記述されている用語を用いて ， A 
体的かつ明確に記述してください.なお，障害と思われる現象については，その現象を再現 
可能な情報が必要です.当社で再現できないものは，調査ができません.その現象が発生す 
るまでの操作手順，データを必ず添付して下さい.データディスクがある場合は，そのコピ 
一も同封していただくと調査がスピーディーになります • 

また，お客様固有と思われるアプリケーションの設計，作成，運用，保守については，当 
社のサポート範囲外ですので，お問い合わせいただいても回答できません.ご了承下さいま 
すようお願いいたします. 
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